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PRELUDE 

TO THE COMMODORE 64 MASTER MEMORY MAP 



Welcome all, beginning or expert programmer, to ESFs 
COMMODORE 64 MASTER MEMORY MAP! This book will be 
your guide into the inner working of the Commodore 64's 'brain cells'. 
This is truly a map, a guide to the special places inside the operating 
system of the computer. These places will help you add new features to 
the programs you write, making them really come alive! 

Along the way, you have the humor of Professor Von Chip and the 
friendly alien Prototype to help make the journey a productive one. 




The Master Memory Map is divided into sections to aid you. Each 
section deals with a particular part of the memor>^ There are lots of 
programming examples, too, because sometimes it's easier to under- 
stand an example when you see it on the screen instead of just reading it. 
Some of the programming examples add a useful utility to BASIC, like 
the RENUMBER routine. Others serve as useful programming 'tricks'. 
In every case, you should study the listings and play with the code to see 
what happens. 

The appendices go into more detail, showing how to do something like 
create sprites or produce a sound. They give longer programming 
examples and show you some of the advanced things you can do with the 
Commodore 64. 

This book really isn't a novel, so you can start reading anywhere. But 
sometime you should read it from cover to cover, sooner or later you'll 
see new ways to use the computer. This moment of enlightenment - a 
creative flash - is what makes working with a computer so much fun! 
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We've worked hard to make the Master Memory Map easy to read 
and use. Look in the upper right hand page comer for a guide that will 
show you which locations are covered on those pages. Just flip through 
the book until you come to the locations you need. The appendix sections 
are also marked in a similar way. 

Prototype, sometimes just called Proto, will help you find locations 
and routines that the beginning or intermediate programmer will use 
most often. Lx)ok for him in the margin as you flip through the book. 

A COPY OF THE PROGRAMS 

The programs in this book are used as illustrations for techniques and 
ideas. You will gain a lot of knowledge if you type in the programs 
yourself. But if you don't want to tire your fingers, send $9.95 to: 

Educational Software, inc. 
4565 Cherryvale Ave. 
Soquel, CA 95073 



A BONUS! 

If you discover a new, unpublished use for one of the memory 
locations send it to Educational Software. In return, we'll send you some 
software, free. 

SOURCES 

A few of the program examples in the Master Memory Map come 
from other sources. The source is identified in the text by using these 
symbols. 

C^: COMMODORE 64 PROGRAMMER'S REFERENCE 
GUIDE, Commodore Business Machines, Inc., Computer Systems 
Division, 487 Devon Park Drive, Wayne, PA 19087. 

Ci COMPUTE! Magazines, Copyright 1982, Small System Service, 
Inc., Reprinted by permission from COMPUTE! Magazine, P.O. Box 
5406, Greensboro NC 25403, 12 Issue, Subscription $20.00. 
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GLOSSARY 



ASCII: The American Standard Code for Information Interchange. 
This is one standard for assigning numbers to the letters and 
characters on the keyboard. Commodore computers do not follow 
a true ASCII (pronounced 'ASK KEY') but have their own code 
instead. 

Accumulaton The results of logic and arithmetic operations are stored 
here temporarily. It acts as a busy bus stop, nobody stays here long! 

Address: The number of a given location. It's just like a street address. 

Attack: The rate a note or sound changes from 'off to its highest 
volume. 



Baud* This is the rate of transmittion of information conveyed over a 
line . This rate is determined by the bits per second that are being 
transfered. You encounter this term if you are using a modem or 
some device that requires special interfacing (RS-232). 

Bit The smallest piece of information the computer can handle. There 
are eight bits in a byte. 

Buffer A storage place. For example, the keyboard buffer stores your 
keystrokes and allows you to type faster. The information in a 
buffer eventually goes somewhere else to be acted upon. 

Bus: A bus is a system of electrical lines shared by all devices that are 
connected to it. This is a convenient way for these devices to share 
addressing and data. It works just like a party line telephone. 

Decay: A musical term meaning the rate of change from the highest 
level to the sustaining level of sound. 



Attack — - 
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Default The beginning value of a memory location especially when the 
power is turned on or other operations are done. 

Disable: Turn off. By disabling the RUN/STOP key, you can prevent 
anyone from accidentally stopping your program. 

Enable: To turn on; the opposite of disable. 

Flag: A signal that something has happened. Flags can be used in your 
own programs. For example: 

If A$ = "ouch" then B = 1 

B is the flag in that statement 

Floating Point Arithmetic operations using decimal numbers. 

Immediate Mode: Using the computer without running a program. 
For example: 

10 PRINT 3+2 

is a program and must be run to get an answer. 

PRINT 3+2 

will answer ''5" when you press RETURN. 

Jump: To go from one location to another. In BASIC, the equivalent 
terms are GOTO and GOSUB. 

KERNAL: This is Commodore's word for a series of machine language 
subroutines that operate the computer. See the Appendix for more 
information. 

Nybble: Pronounced 'nibble'. A nybble is half a byte. Really. The low 
nybble is composed of bits to 3. The high nybble has bits 4-7. 

Operating System: Sometimes this is referred to as the OS. Part of this 
is the KERNAL described above. Its job is to make the computer 
run. 
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Page: A page is 256 bytes of memory. The computer often keeps track 
of different blocks of memory in terms of pages since it is easier for 
the computer to store. 

Pointen It does just what it says, it acts as a signpost telling the 
computer where to look for information. 

RAM: Random Access Memory. This type of memory can be easily 
changed. Your programs are stored in RAM, and when the 
computer is turned off any information in RAM is lost. 

ROM: Read Only Memory. This type of memory does not change when 
the power to the computer is turned off. Examples of ROM 
memory include BASIC and the KERNAL. 

Register Another name for memory location. Registers can be more 
than one byte long. 

Release: A musical term describing the rate of fall from the sustain level 
to zero volume. 



Reserved Word: Letters that can't be part of your program. Examples 
of reserved words are the status word, ST, and the time words, TI 
and TI$. To save yourself from trouble, don't use any variables in 
your programs that have the same starting letters of any BASIC 
command or have BASIC words in them. 

Sustain: Another musical term used with the sound capabilities of the 
computer. This extends the sound, like the pedals of a piano. 



Waveform: This term is a description of the type of sound produced. 
The computer has four different waveforms; triangle, sawtooth, 
pulse and noise. Each type produces a different kind of sound. 

Vector This is another kind of pointer. It refers to the starting address of 
a routine. The computer needs to know where to look for things. 




— Release 



Sustain 




\ 
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How to 



PEEK and POKE 

This part is for those who have yet to learn how to use a memory map. 
Basically, a memory map is a list of valuable locations within the 
computer (in this case a COMMODORE 64), that you can directly use 
for various purposes. These locations are called bytes (memory loca- 
tions) of memory at a specific place. With 64K of memory, there are 
64*1024 memory locations that you can work with. Although some of 
these bytes are used for the computer's Operating System, most of them 
are blank for you to use in your programs. This manual will tell you about 
the ones that you can do something with. 

For example, you can quickly look down this list to find that location 
650 controls the repeating of certain keys, like the space bar. By 
following the included hints, you can change the ''normal" value in that 
location, so that when you pvQSsany key it will repeat as long as you hold 
it down. Please note that any of the changes that you make are only 
temporar>^ and will go away when the computer is turned off. 

Now to explain how to make changes from BASIC. Say you look 
down the list and decide to change location 650 ( all numbers are decimal 
unless marked with a $ symbol, which denotes a HEX-adecimal 
number, or in a column marked ''hex"). 650 is called RPTFLG by 
Commodore. Its function is to decide which keys on the keyboard to 
repeat. So, if you would like all the keys to repeat as long as you hold the 
key down, you simply look up the correct value to POKE into location 
650. 

In this example, the memory map says to use the number 255 to repeat 
all keys. The BASIC instruction to put a number into memory is called 
"POKE". After all this long-winded explanation, you can now see how 
simple it is to make this change: 



POKE 650,255 



— HINT — 



Always use the decimal numbers with a POKE statement. This means 
that sometimes you will have to convert between binary, hexadecimal 
and decimal. Also, any one memory location can only hold a number up 
to 255. Why?... remember that the COMMODORE uses eight bits per 
word (memory location), and eight bits in binary counts from to 255 
(internally, the machine uses binary). You may want to study the next 
section of the manual, "Bytes and Bits" to learn about binary. Because of 
this limitation, sometimes you must POKE numbers into two locations 
in a row. 

For example, look at memory locations 643 & 644 which are called 
MEMSIZ. These locations hold a number that corresponds to the top of 
your available memory (called RAM - Random Access Memory). Since 
the top of memory can be up to 40960, a number well above the limit of 
256 for any one memory location, the computer will need two locations 
to store the value. Yes, I know 256 for the first location plus 256 for the 
second doesn't seem to add up to a large enough number to hold 64K, but 
the computer takes each number in the second location and multiplies it 
by 256. Examples: 

1 1 stored in the low byte 
+ 1 stored in the high byte 
267 

The computer ''sees'' 256*1+1 1 which equals 267. 

Another example: 

121 in the low byte 
-f 7 in the high byte 
1913 

Since 7*256 +121 = 1913. 

Sometimes it is desirable to fool the COMMODORE 64 into thinking 
that the top of memory is lower than it actually is, perhaps to keep it from 
using the last thousand bytes of memory, thus reserving them for Sprites. 
You do the same type of POKE here as in the first example, except that 
you have to do it twice; once for the ' ' LOW" part of the number and once 
for the "HIGH" part. 
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I said the LOW part of the number is placed in the first memory 
location and the HIGH part is next. Although it seems backwards, this is 
really not hard to understand. The COMMODORE (and most other 
micro-computers) store multiple part numbers this way. Occasionally 
this rule is broken, so please don't call me up if you find an exception. 

Here's what you do. We want to change the value of MEMSIZ to be 
1 K less than it currently is. 

1) Find current value... 

10 A = PEEK(643)-fPEEK(644) * 256 
LOW Part HIGH Part 

This number will be 40960, which is the value of MEMSIZ, when 
the 64 is turned on. 

2) Subtract IK from this value... 
20 A - A-(l * 1024) 

Remember that one K is actually 1024 bytes. 

(You don't have to use 1, you can can change the size by any 

number.) 

3) Break the new value up into LOW and HIGH parts... 

30 B = INT(A/256): C = A-(B * 256) 
B would = 156, C would = 

What this does is make C the LOW part of the number and B the 
HIGH part. 

EX: 40960-1 K= 39936 

Line 30, when run, will give you 156 for the HIGH part and for the 
LOW part. 

4) POKE these values into memory... 

40 POKE 643, C: POKE 644,B (#'s in decimal!!) 
EX: POKE 643,0:POKE 644,156 
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!! FINAL WORDS OF WISDOM !! 



1 ) Feel free to POKE and PEEK all you want, trying out ideas or 
testing the effects mentioned in the Master Memory Map. The 
explanations are only the most basic part of how to do the various 
effects possible on the COMMODORE. Watch for EDUCA- 
TIONAL SOFTWARE'S series of TRICKY TUTORIALS 
that will take you step by step through Sprites, Page Flipping, 
Sound, Animation and other uses of the computer. These are the 
techniques that the best programs use, and all of our Tutorials are 
done in BASIC, although we do sometimes include a machine 
language subroutine to offer you some advantage like speed. 

2) Remember that two numbers are required to tell the computer the 
value for some locations, and these are stored LOW part first, 
HIGH part second. This is opposite of what you might think. 

3) All of the memory locations are here, but many are for advanced 
users only. Don't feel bad if you have no idea what they are for. The 
idea is to experiment and learn. 

4) You can usually press Run/Stop and Restore if trouble occurs. 
This will restore the original (default) values of many locations. 

5) Some locations in the Master Memory Map are used to read from 
only; that is, you can PEEK to see what is there, but you can't 
POKE your own number in. This is because part of memory is a 
type called ^^ROM" which means ^^READ ONLY MEMORY". 
This type is permanent and can't be changed by POKEing, but 
Commodore has thoughtfully provided a way for you to put a copy 
of the ROM into memory so you can change it if you wish. 

Go back and re-read the last section at least a few hundred times. 
There are only four lines in the program that both read the old value of 
MEMSIZ and store a new value. These lines don't have to be part of a 
program. You could enter them directly. 
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BYTES and BITS 




To PEEK & POKE you need to understand what a byte is and how it 
is structured. It isn't too hard to understand - and you can use the Master 
Memory Map without learning too much about them - but the more you 
know about Bytes and Bits the more you'll learn about controlling your 
Commodore. 

A BYTE is really not complicated at all. A BYTE is simply a group of 
eight BITS. When eight BITS are structured into a BYTE then each of 
those BITS have special significance. You look puzzled! What, you say, 
is a BIT? 

A BTT is the smallest piece of information a computer can deal with. In 
fact, the computer only deals with BITs at the most fundamental level. It 
may be helpful ^o imagine the microprocessor as a bus station. This bus 
station has only one single lane road attached to it. That means a bus can 
only travel in one direction at a time as there is not enough room for two 
busses to pass each other. Therefore, a bus may either be arriving at the 
station or departing. The microprocessor, or bus station, can schedule its 
bus with a signal light that says ^T AM ACCEPTING ARRIVALS" or 
^T AM SENDING DEPARTURES". 

In fact, in real computer hardware architecture, the wires that carry 
information to and from a microprocessor are called the DATA 
BUSSES. We don't need eight separate INPUT and eight separate 
OUTPUT wires because, like the single lane road connected to the bus 
station, the wires are bi-directional, that is, information can either be 
arriving (INPUT) or departing (OUTPUT). The microprocessor also 
has a signal of its own that determines whether it will receive ( INPUT) or 
send (OUTPUT) information. 
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WHO'S RIDING THE BUS? 




Let's take a closer look at that bus. It is known as the BYTE express, 
has eight seats, and always carries eight passengers. Those passengers 
are little messengers known as BITs, and, as a group, they are known as a 
BYTE. These messengers, or BITs, are rather moody. They are either 
turned "ON" or they are turned "OFF". That is called BINARY as they 
are BI-STATE signals, ON being a " 1 " state or OFF being a "0" state. 
Their vocabulary is just as limited.. .the only thing they are willing to tell 
you is their mood. Now how do we get any meaningful information out of 
a group of eight little monsters standing in front of us, each screaming 
"ON" or '^OFF" at one time? 



Well, when the bus arrives, we could have the whole BYTE stand in 
front of us and count everyone who is turned "ON". That would give us 
the capability of counting to eight. Seems pretty limited, doesn't it? 
Hmmm, the group really needs a leader. That leader will be the first BIT 
on the left. We'll call that BIT the Most Significant Bit, or the MSB. The 
last BIT on the right will be the Least Significant Bit, or LSB. Terrific! 
Now that we have a group leader and group follower, then all the BITs 
should have a rank. 




Handing out ranks is a serious matter and much thought should be 
given to it. We can start with the LSB and assign that BIT the rank of 
" 1 ", since it is the Least Significant Bit. We can be easy on everyone if 
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we just double that rank for the next BIT in hne. So, why not just keep 
doubling the rank for the next BIT in line and so on until we get to the 
MSB or Most Significant Bit. Now out BYTE looks something like this: 

I BYTE 1 

MSB LSB 

RANK|Tggg[T7|Q 



MESSAGES WITH MEANING! 

What have we gained? More than meets the eye! When the BYTE gets 
off the BYTE express and each BIT starts telling us what their mood for 
the day is, we can make a different and more meaningful interpretation 
out of the ignorant little beasts. If everyone is turned "'OFF" except the 
fourth BIT from the right we can check the rank of that BIT and fmd it is 
eight (8). Unknown to the BITs, they have brought us a message and the 
message is ''8". 

Computers are very efficient and do not like to waste information, 
therefore, computer related numbers usually start at BASE ZERO (0) 
since zero is unique. We usually like to start counting with one ( 1 ) for the 
convenience of our tliinking process. That way, the number we arrive at 
when we have counted the last item actually represents the number of 
items we counted. Normally, we would count the BITs as one (1) 
through eight (8). The computer thinks a little more efficiently than 
mortals and sees BITs zero through seven as representing eight (8) 
individual BITs. 

VALUE 128 64 32 16 8 4 2 1 

err 7 6 5 4 3 2 1 

If you SET or turn ^^ON^' only the fourth BIT (BIT #3) from the right 
you will observe a value of eight (8) in the value box. That was the 
message we received! 

Aha, we now want the BITs to get on the bus and carry a message back 
to the sender. We want them to tell the sender ''9". Oops, a small 
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problem, there is no BIT with the rank of nine in the BYTE. What to do, 
what to do? I guess the next best thing is to be very nice to the LSB, pat it 
on the head, and turn it "ON", then when the sender receives our 
message from the return BYTE he will find BITs with the rank of " 1 " and 
"8" turned "ON". Adding those ranks together gives us a numerical 
range of to 255. That is a total of 256 cases if you count as a case. 



VALUE 128 64 32 16 8 4 2 1 

BIT# 7 6 5 4 3 2 1 

Well, that's how you get the numbers to POKE into the locations in 
the Memory Map. Let's just take one more example. If Proto was a 
Sprite, he would have a number from to 7. Sound familiar? To let Proto 
be Sprite number 0, turn on the zero BIT in location 53269. 

POKE 53269,1 
BIT# 7 6 5 4 3 2 1 



□ □□□□□□ 




VALUE 128 64 32 16 8 4 2 1 

For Proto to be Sprite number 3, turn on BIT 3. 

POKE 53269,8 

VALUE 128 64 32 16 8 4 2 1 
BIT# 7 6 5 4 3 2 1 



MMM-B 
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To have 4 different Sprites on the screen, turn on the BIT for each Sprite. 



VALUE 128 64 32 16 8 4 2 1 
BrT# 7 6 5 4 3 2 1 



Turns on Sprites #5, 3, 2 and 1. 

Confusing? Just read this a few thousand times and play, play, play 
with the locations in the Master Memory Map. The more you play, the 
more you learn! 
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LOWER ADDRESSES 



LABEL 

Hexadecimal Decimal Decription and 

Location Location How to Use 

If you're interested in programming only in BASIC, the first two 
locations won't be of much interest. Later, when you want to try machine 
language programming, take a good look here. 

D6510 

0000 This is the place on the computer's 

main processor (the 6510) or 
''brain", that monitors or "looks at" 

the information going in and out of itself This location is not useful if you 

program only in BASIC. If you are interested in writing machine 

language programs this is what you need to know: 



NAME 


BIT 


DIRECTION 


DESCRIPTION 


LORAM 





OUTPUT 


Control for RAM/ROM at 








$AOOO-$BFFF (BASIC) 


fflRAM 


1 


OUTPUT 


Control for RAM/ROM at 








$EOOO-$EFFF 








(KERNAL) 


CHAREN 


2 


OUTPUT 


Control for I/O/ROM at 








$D0OO-$DFFF 




3 


OUTPUT 


Cassette write line 




4 


INPUT 


Cassette switch sense 




5 


OUTPUT 


Cassette motor control 
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If the bit is set to 0, input is coming from the memory block. If the bit is set 
to 1, the processor is sending information to the routine. Normally this 
location is set to 47. 

R6510 

0001 1 This location is a little more useful to 

the BASIC programmer. It is respon- 
sible for dividing the memory into 
pieces the computer can handle. 

In addition to 64K bytes of RAM memory, the Commodore 64 has 
20K bytes of ROM containing the Kernal, screen editor and BASIC 
interpreter plus another 4K for the character generator ROM. Another 
4K to 8 K is available in expansion cartridges. This effectively allows the 
microprocessor to look at 92K bytes of memory! However, only 64K is 
accessible to the 6510's address space at any one time. 

Before we go too much further, here's a practical use of this location. 
Using this address and others you can create your own character sets for 
graphics or animation. To do this you must move the character generator 
ROM into RAM so you can change an ''A'' into a tiny Pro to! See the 
appendix for an example of creating your own characters. 

If you are interested in what happens when each bit is turned on or off, 
here's a handy list of the locations and the different kinds of memory 
configurations that can be made. 

Bit# 

LORAM SIGNAL (0 = switch BASIC ROM OUT) 

1 fflRAM signal (0 = switch KERNAL ROM OUT) 

2 CHAREN signal (0 = switch character ROM IN) 

3 Cassette data output line 

4 Cassette switch sense 1 = switch closed 

5 Cassette motor control 1 = ON, = OFF 
Bits numbers 6 and 7 are not used. 
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MAP # 


BITS 2-1-0 


FUNCTION 


Map-0 


111 


38K BASIC 


Map - 1 


XOl 


60K RAM & I/O 


Map - 2 


110 


Z-80 CP/M Cartridge 


Map - 3 


1 f\f\ 
100 


64K free memory 


Map - 4 


111 


Expansion count 


Map - 5 


110 


Assembler/wordprocessor 


Map - 6 


111 


No BASIC 


Map - 7 


IXX 


MAX machine games 



Note: X = not available for user 



The "Max Machine" is a game machine that Commodore hasn't 
released in the U. S. yet. The game's cartridges will also work on the 64. 
If the Max Machine game cartridge is plugged in, map 7 is not available 
to you. 

If it isn't fun figuring out the values for this location, remember that it is 
affected by different cassette operations (see the appendix ''Recon- 
figuring the Memory Map" for diagrams of the different map possibil- 
ities). If you think you really have problems 

POKE 1,255 

and your ROMs will reset and the system will be its good old self again. 
This is one place where pressing RUN/ STOP and RESTORE won't 
work. 



0002 



This is used by the computer to tem- 
porarily store information it needs. 
Don't use this address, it could upset 
the machine. 



ADRAYl 
0003-0004 



3-4 



Jump vector: convert floating-point 
real numbers to integer. 



ADRAY2 
0005-0006 



5-6 



Jump vector: convert integer numbers 
to floating-point numbers. 
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CHARAC 
0007 



ENDCHR 
0008 

TRMPOS 
0009 



Search character. This location 
stores the ASCII value for a quote 
(34). 

Flag: scan for quote at end of string. 



Screen column from last TAB. 



VERCK 
OOOA 



COUNT 
OOOB 



DIMFLG 
OOOC 



VALTYP 
GOOD 
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11 



12 
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Flag: = Load 1 = Verify 

The value changes with the last disk 

or tape operation. 

Input buffer pointer number of sub- 
scripts. 



Flag: default array DIMension 
This location holds the value of the 
first letter of the most recent dim- 
ensioned array. 



This shows the type of data being 
read. 255 if it is string data and if it is 
numeric. 



INTFLG 
OOOE 



GARBFL 
OOOF 



SUBFLG 
0010 
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15 



16 



This shows data type for numbers. 
128 for integer and for floating 
point 



Flag: DATA scan for LIST and gar- 
bage collection. Normal value: 4. 



Flag: Subscript reference and user 
function call. This location doubles 
as flag register for these two func- 
tions. 
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INPFLG 
0011 



TANSGN 
0012 



17 
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Flag: BASIC input types. 
= INPUT, 64 = GET, 
152 = READ 

This shows when power is turned 
on. The value will change as the input 
type changes. 

Flag: TAN sign/comparison results. 
This flag tests SIN/COS division 
results to verify the tangent sign. The 
normal value is 0. This value be- 
comes 255 when TAN argument is 
greater than 259.1. 



0013 
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Flag: input prompt. 



LINNUM 

0014-0015 20-21 



Temporary storage of integer value. 
BASIC stores integer variables used 
in calculations here. The routines in 
locations 3-4 and 5-6 use the 
number stored here. 



TEMPPT 
0016 
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Pointer: temporary string stack. 
Normally points to TEMPST (25). 



LASTPT 
0017-0018 

TEMPST 
0019-0021 

INDEX 
0022-0025 



23-24 



25-33 



34-37 



Last temporary string stack. 



Stack for temporary strings. 



The addresses stored here point to 
machine subroutines stored in the 
BASIC ROM. 



RESHO 

0026-002A 38-42 This holds the results of floating point 

multiplication. These locations are 
used by the system ROM multiply 
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routines whenever very large positive 
or negative numbers are multiplied. 



TXTTAB 

(X)2B-002C 43-44 Pointer: start of BASIC text. 

Normal value: $0801(2049). 

Now here's a location everyone can use! These addresses point to the 
place the computer looks for your programs. You can fool the computer 
into thinking it has less room than it really has so you can "hide" a 
program. This location combined with others gives you: 




With an append routine you can load one program after another and 
keep both programs in memory! Why would you want to do this? Here is 
an example. If you include a joystick routine in every program you write, 
then typing in the same lines time after time is something you can give up. 
First, just save the joystick routine separately. Give it high line numbers 
like 20000 or 30000. Then, whenever you need it, use the append routine 
to add it to any program you want! The high line numbers should keep 
your joystick routine above the rest of your program so you won't need to 
renumber them. 



The programs for this location were printed using Midwest Micro 
Associates printer interface program "Smart ASCII". Each 
Commodore cursor control character or color character is translated into 
English and printed within parentheses. 

(CLR) means the CLEAR/HOME key and will look like a reversed 
heart when you enter the program. (DN) means cursor DOWN, (LF) 
means cursor LEFT, and (HM) is cursor HOME (without clearing the 
screen). Two color controls are used, (BLU) for blue and (WHT) for 
white. Use the appropriate keys to produce these colors. 
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41-44 



If you use a cassette to save programs, 

1 . Enter the following program: 

1 A=PEEK(44) 

2 PRINT" (BLU) (CLR) (DN) (DN) (DN) LOAD (DN) (DN) 
(DN) (DN) (DN) (DN) (DN) (DN) (DN) (DN) (LP) (L 

P) (LP) (LP) PGKE43, 1 : PUKE44, " ; A? " (HM) (WHT)" 

3 POP I =63 110636 5 POKE I , 13: NEXT 

4 POKE 198, 6 

5 IPPEEK (45) <2THENP0KE43,PEEK (45) -2-+-2'55^ 
P0KE44 , PEEK ^ 46 ) - 1 : END 

6 P0KE43,PEEK(45)-2:P0KE44,PEEK(46) s END Q 

2. Put the cassette with the first program you want to add into the 
cassette drive. 

3 . Run the append program and follow the directions given on the screen. 

When the word "READY" appears, type LIST and you will see the 
second program listed AFTER line 6. To add another, put the new 
program in the cassette and type RUN again. When you have added all 
the programs you want, delete lines 1 through 6. 

If you have a VIC-1541 disk drive, make the following changes and 
additions to the program: 

1 INPUT "ADD WHICH PROGRAM Pt- 

2 A=PEEK ( 44 ) : Ql^::=::CHR^ ( 34 ) 

3 PRINT" (BLU) (CLR) (DN) (DN) ( DN ) LOAD " ; QiT- ; P^^ ; 
0:$: ; " , 8 ( DN ) ( DN ) ( DN ) ( DN ) ^ DN ) ( DN ) ( DN ) ( DN ) 
(DN) (DN) (LP) (LP) (LP) ( LP ) P0KE43 , 1 : P0KE44 , 
" ; A 5 " (HM) (WHT) " 

4 P0RI=631T0640: POKEI , 13; NEXT 

5 POKE 198, 10 

6 I PPEEK ( 45 ) < 2THENP0KE43 , PEEK ( 45 ) -2-+-255 : 
P0KE44 , PEEK ( 46 ) - 1 : END 

7 P0KE43,PEEK(45)-2:P0KE44,PEEK(-6) s END CI 

Type Run and follow the directions given on the screen. When you 
finish, be sure to delete lines 1 to 7. If you have programs with the same 
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line numbers, you will have to renumber both programs. For a handy 
renumbering program, see address 2040. You can see how the program 
works by POKEing your screen to a light gray (POKE 5 328 1 , 1 2) so all 
the commands will show. 

Briefly, this is what happens. First, adjustments are made in locations 
43 to 46 to move this program safely out of the way of the program you 
are about to add. 

Then in line 3, two things happen. First the LOAD command is 
printed, then the POKE commands that will be needed later to find our 
hidden program. In line 4, you put carriage returns in the keyboard buffer 
(locations 63 1-640) and tell location 1 98 how many you put there. Line 
5 "hides" any program in memory from the computer so the program 
isn't lost when you add the new one. Then the program ends. 

Ending the program causes the computer to act on anything in the 
input buffer, which we have conveniently stuffed with carriage returns 
(CHR$ (13)). Since the program has already printed commands on the 
screen, the carriage return enters these commands just as if you did it 
yourself. That's a lot for only 7 lines of code! 

Here's a scrolling routine that uses some of the same concepts. This 
routine will let you see one line of program at a time. 



6 3 f^' E ( 1 * / - LIST 

6300 1 SA^PEEK ( 44 ) *256+PEEK ( 43 ) ~ 1 

63002 LN^PEEK ( 3A-I-3 ) +PEEK ( SA + 4 ) *256 

63003 PRINT" (CLR) (BLU) GOTO 63010":PRINT 
"LIST" ; LN; 

63004 P0KE63 1,19: PQKE632 ,17s POKE -33 , 5 s 
PGKE634, 13spnKE635, 19:PGKE636, 13 

63005 POKE 198,6: END 

63010 IP PEEK (197) =:43 THEN 63 100: REM TEST 

POR "~" KEY 
63020 IP PEEK (197) =40 THEN 63200: REM TEST 

POR "•+•" KEY 
6 3 3 G T 6 3 1 

63100 IP PEEK(SA+5) < >0 THEN SA-=S^:^4- 1 : GOTO 
63100 

63110 SA=SA+5:G0T0 63002 

63200 SA=SA-1;IP PEEK(SA)=0 AND PEEK(SA-4) 

<>0 AND PEEK(SA-3)<>0 THEN 63002 
63210 GOTO 63200 ^ 
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Here's how to use it. 

1 ) Load the program you want to scroll. 

2) Enter the following BASIC without using line numbers (this is 
called the immediate mode). 

CLR POKE 43,PEEK(45)-2:POKE 44, PEEK (46). 
This makes BASIC think it has less memory for the next step. 

3) Load the scrolling program. 

4) Enter the following in the direct mode. 

POKE 43,l:POKE 44,8 

5) Type 'RUN' and press retum. 

6) Press the minus (— ) key to scroll down to the next line. Press the 
plus (+) key to scroll up one line. You must scroll down at least one line 
before you scroll up or the program will end. 



VARTAB 

(X)2I>002E 45-46 Pointer. Start of BASIC variables. 
ARYTAB 

002F-0030 47-48 Pointer: Start of BASIC arrays. 
STREND 

0031-0032 49-50 Pointer: End of BASIC arrays(+l). 

These locations are similar to location 43-46. These give the area 
where arrays are stored after they are DIMentioned in your program. 
Being able to find the starting addresses of your string arrays will be 
needed if you're storing short machine language subroutines in them. 
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This sample program creates 3 different types of arrays then allows 
you to see how the computer stores them. Press any key to look at each 
location. Press RUN/STOP to end. 



100 REM ^^-^i^^- ARRAY SAMPLES -^-^ m- ^ ^- ^ ^- m- ^ ¥r 

110 DIM C1i(5), R(5) 

120 : 

130 REM M-^^^- ARRAY POINTER PN ^m-^-^^mm-w^ 

140 DEP PNARRAY(X)-::pEEK(X)-t-256-^PEEK(X4-l) 

150 : 

160 REM ^^^^ STUPP THE ARRAYS ^ ^- ^- ^- -^^ ^ ^ 

170 PGR I - 1 TD 5 

180 R(I)=-I 

190 C^(l) - CliR$(65+I) 

200 FDR J - 1 TO 5 : I ^'l (I , J ) - J : NEX T 

210 : 

220 REM PIND ARRAYS IN MEMORY m-m^m 

230 AS - PNARRAY(47): REM ARRAYS START* 

240 AE - PNARRAY(49): REM ARRAYS END-*^-^^ ^- 

250 : 

260 REM PRINT ARRAY ELEMENTS **)^** 

270 PGR T-- AS TO AE 

280 PRINT T,PEEK(T) 

290 WAIT 197,64,64^ REM PRESS ANY KEY-*^* 

300 NEXTT 

310 CLR 

320 REM ■^■^■^■^ PRESS RUN/ STOP TO END ^^^m- 

330 GOTO 330 



FRETOP 

0033-0034 51-52 Pointer Bottom of string storage. 

FRESPC 

0035-0036 53-54 Utility string pointer. 



These two locations point to the end of the Random Access Memory, 
(RAM), used to hold strings like "Hello" or ''My name is Prototype". 



24 



St-54 




Often, programmers use these locations and the next two in a com- 
bination that allows them to hide part of the memory from the 
computer. Typically, you may want to reserve a large portion of your 
memory for keeping things like longer machine code subroutines, binary 
data files, or fonts (modified character sets) resident but not accessible 
by BASIC interpreter routines. 



The next two locations show how this is done. 
MEMSIZ 

0037-0038 55-56 Pointer Highest address used by 

BASIC. In other words, your 
programs won't be stored beyond 
the value shown in these 2 bytes. 
Normally this is set to 40960 but 
you can change that if you want. 

To set aside 4K of memory for machine programs, graphic 
characters or sprites in the program mode, use this routine in the 
'immediate mode'. 

POKE 51,0:POKE 52,144:POKE 55,0:POKE 56,144:CLR 

This will save the area from 36864 to 40960. (9000-9FFF in 
hexadecimal notation) 

POKE 51,0:POKE 52,160:POKE 55,0:POKE 56,160:CLR 

This will restore the machine to normal. 
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CURLIN 

003 9-003 A 57-58 Current BASIC line number. 



OLDLIN 
OO3B-003C 



59-60 



Previous BASIC line number. 



These address registers point within memory used by BASIC where 
the program line numbers are stored. You can determine these line 
numbers by 



OLDTXT 
003D-003E 



DATLIN 
003F-0040 



PRINT PEEK(57)+256*PEEK(58) 



61-62 



63-64 



This contains the address where 
BASIC code is to resume after the 
program has been STOPped. It is 
used with the BASIC command, 
CONT. This is normally set at the 
beginning of BASIC (2048) when 
there is no program resident. 



Current DATA line number. These 
locations store the line number of 
either the first DATA statement in a 
program or the current DATA state- 
ment being read. 



100 DIM INZ\Z) 

200 FOR I ^ 1 TO 3 

300 READ liMXd) 

400 NEXT 

500 PR I NT ( PEEK ( 63) +256 

600 DATA 1,2,3 



^PEEK(64) ) 



Running this program will show the number 600 as the current DATA 
Hne. By using a routine like this while you're de-bugging your program, 
you'll be able to see if all of your DATA statements are being read. 

DATPTR 

0041-0042 65-66 Pointer: This is the address of the 

current DATA item. When no 
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S7-M 



DATA statements are encountered, 
this location defaults to 2048. 



Did you know that each type of DATA needs a different amount of 
memory to store each part? Whole numbers take 2 bytes, characters take 
3 bytes and floating point numbers take 4 bytes. 

INPPTR 

0043-0044 67-68 This address shows where the 

INPUT statement temporarily stores 
its data, which is the system INPUT 
buffer starting from locations 5 12 to 600 (78 bytes). You can't POKE 
this location to change the size of the INPUT buffer. By the way, trying 
to put more information in the buffer than it will hold will cause the first 
78 characters to be lost. 



YARN AM 
0045-0046 69-70 



VARPNT 

0047-0048 71-72 



FORPNT 

0049-004A 73-74 



004B-0060 75-96 



Current BASIC variable name. 
When a single letter variable has been 
used, this location returns its ASCII 
value. 

Pointer Current BASIC variable 
data. This is just another location 
which points to base address of the 
BASIC variable table (normally 
2084). 



Pointer. Index variable for FOR/ 
NEXT, loops. 

Temporary pointer / data area. 



The 16 locations from 97 to 1 12 are arguments for the floating-point 
arithmetic routines stored in the KERNAL ROM. They can be used in 
BASIC, but they provide the assembly language programmer with the 
ability to perform any arithmetic operations on two numbers (accum # 1 
and #2) without vmting those routines BASIC uses. 

These locations are also very useful for machine language subroutines 
that are called from BASIC. See locations 784-787. 
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If you are interested in mastering machine level programming, take a 
look at Rodnay Zak's books on 6502 programming. They are concise 
and thorough. 



FACEXP 
0061 



97 



FACHO 

0062-0065 98-101 



Floating-point accumulator #1: ex- 
ponent. 

Floating accumulator #1: mantissa. 



FACSGN 
0066 



102 



Floating accumulator # 1 : sign. 



SGNLG 
0067 



103 



Pointer: Series evaluation constant. 



BITS 
0068 



ARGEXP 
0069 

ARGHO 
006A-006D 

ARGSGN 
006 E 



104 



105 



Floating accumulator #1: overflow 
digit. 



Floating-point accumulator #2: ex- 
ponent. 



106-109 Floating accumulator #2: mantissa. 



110 



Floating accumulator #2: sign. 



ARISGN 
006 F 



111 



Sign Comparison Result Accum. # 1 
vs #2. 



FACOV 
0070 



112 



FBUFPT 

0071-0072 113-114 



Floating accumulator 1. Low-order 
(rounding). 



Pointer: cassette buffer. 
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Locations from 1 1 5 to 1 38 are part of the computer's operating system 
that are deliberately put in RAM for the user to be able to change it. For 
instance, you could add commands to BASIC. 



CHRGET 
007 3-008 A 



1 15-1 38 This machine language subroutine is 

what the computer uses to get char- 
acters or tokens from the 
keyboard, cassette, disk or modem. 



Here is what it looks like disassembled: 



H ^ .i^j / 5 Oi.^ O 2 

,,0077 E6 7B 

,j0079 AD 60 

,007C C -v 3 A 

,007E BO OA 

, 0080 G9 20 

,0082 f-0 EF 

,0084 38 

,0085 E9 30 

,0087 38 

,0088 E9 DO 

, 00 8 A 60 



I NO ::|: / A 

BNE il-oO 7 9 

INC ^■7B 

L.DA 4:-EA60 



CMP 

BCS 



#:|:3A 
:ii^008A 



i:MP #*20 
BEQ 
SEC 
SBC 



:^i:007 

#^30 



SEC 

SBC #:^^D0 
RTS 




The next two locations are checked by the CHRGET routine. 

121 Entry to get same byte of text again. 



CHRGOT 
0079 



TXTPTR 

007A-007B 122-123 



Pointer: current byte of BASIC 
text. 



RNDX 
008B^008F 

STATUS 
0900 



139-143 



144 



Floating RND function seed value. 



Kemal I/O status word (ST). 
Normal = 0. ST is a reserved word 
in BASIC, you can't use it as a 
variable (like'^A" or'^B2'') in your program. The value of ST will 
change if there is a problem loading a program from tape or disk. 



MjMM-C 
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10 REi'l ADD THIS BEr nr;;E ANY INf-'ini!^ OR 

20 REM---GET# STATEMENT TO ERE VENT A 

30 REM---RR0GRA1'1 ERCJN STORE I NG Ai TEi< IRE 

40 REM LAST DATUM HAS BEEN READ., 

50 REN----ERGN rNE TARE GR DISK EII..E,. 

60 IE BT 64 THEN 90 

70 : 

B0 : 

90 RR I NT "END GE DATA " 



ST 
Bit 

Position 


ST 

Numeric 
Value 


Cassette 
Read 


Serial/'RW 


Tape 
Verify 
or Load 


write 



1 




Time out 




read 
1 


2 




Time out 




2 


4 


Short block 




Short block 


3 


8 


Long block 




Long block 


4 


16 


Unrecoverable 
read error 




Any 

mismatch 


5 


32 


Checksum 
error 




Checksum 
error 


6 


64 


End of file 


*EOI line 




7 


128 


End of tape 


Device not 
present 


End of 
tape 



♦Evaluate or Input 



STKEY 
0091 



SVXT 
0092 



145 



146 



Flag: STOP key and RVS key. 
Normal: 255 

POKE 145,127 will act as a RUN/ 
STOP key. 

Timing constant for tape. 



VERCK 
0093 



147 



Flag: = LOAD, 1 = VERIFY 
Stores the last tape or disk LOAD or 
VERIFY operation. 
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144. IS4 



Flag: Serial Bus, output character 
buffers. 



Buffered char, for serial bus. 



Cassette synchronization number. 
Temporary data area. 

Number of open files and index to 
file table. Only 10 files are allowed 
open. If you try to open more than 
10 files at any time your program will stop and show a ''too many files 
open" error. If you're opening close to ten files in a program, add lines 
like these to prevent the problem. 

2m IF F-'EEK ( :i52) -10 THEN 400 

Zm OPEN 1,1, 1 

310 GGTG 500: REM--C(JM TINUE 

4 00 P R I I^J T' ' ' 1 F I L E S a R E F F. IM . ' ' 

410 PRINT"DG YGU WANT TO CLOSE" 

420 INPUT"ANY" ; F^IB 



DFLTN 

0099 153 Default input device normally set 

to the keyboard (0). 

DFLTO 

009 A 154 Default ouput (CMD) device 

normally set to the screen (3). 

When you turn the power to the computer on, the screen is where 
you see information. The BASIC command CMD changes that if 
you use an open statement. For example, to have a printer send a 
listing of a program you already have in memory, do this: 

OPEN 1,4: CMD 4: LIST 



C3P0 

0094 148 



BSOUR 

0095 149 
SYNO 

0096 150 

0097 151 
LDTND 

0098 152 
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Here's a list of the different numbers used. 




DFVirF 




NUMBER 


PERIPHERAL 





Keyboard 


1 


Cassette 


2 


Modem 


3 


Screen 


4 or 5 


Printer 


8 to 11 


Disk Drive(s) 



PRTY 
009 B 

DPSW 

009C 

MSGFLG 
009D 



155 



156 



157 



Tape character parity. 



Flag: Tape byte-received. 



Flag: 128 => Direct mode 
Program mode. 



PTRl 

009E 

PTR2 
009 F 



158 



159 



Tape pass 1 error log. 



Tape pass 2 error log. 



This is the ''JIFFY" clock. A jiffy is 
l/60th of a second. The computer 
uses this to help time the different 
operations it performs. Here's what these locations do: every l/60th of a 
second 1 is added to the number in 162 until it reaches 255. Then, 162 
turns to zero and 1 is added to 1 6 1 until it reaches 255 . Then 1 6 1 turns to 
zero and 1 is added to 160. When 160 reaches 255 all 3 locations are set 
to zero. You can use this location to make a stopwatch to check your 
reaction time. 



TIME 

00A0-00A2 160-162 
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154 - 162 



100 F"'F-<INTCHF<* ( 147) 

1 10 PRINT" ST OPmJCH/ REACT in\\ } 1 hl[- " 

1 20 PG|::;E 53280 , 1 : PGK:E5328 1,1: PG1-::E6 <■) 6 . <::^ 
130 PF^INT 

140 PRINT 

1 1^5 P R 1 N T • ' W I I E N Y (J U S E E T f I E B L U E WE n R T „ ' ' 

160 PRINT" PRESS T! !E SPACE BAR AND YOUR" 

170 PRINT" REACT ION TINE NICE BE SNGWN-" 

180 B^=INT ( 10 )^ RND (1 ) ) 

190 PGR PAUSE=:: 1 TG 8^300;; NEXT 

200 EGR D== 1 TG 3 : ER I NTCHRI^ (17): NE X T 

2 1 PGRF<== 1 TG 1 2 : PR I N T CHR$ ( 29 ) ; : NE X 1 

220 PRINTCNR^ ( 1 15) 

230 PGR I - 1 60T G 1 62 " PGKE 1,0: NE X T 

2 4 I E P E: E K ( 1 9 7 ) == 6 4 T H E. H 2 4- 

250 PR I NT ( peek: ( 1 60 ) ^ 655364 PEEK: ( 1 6 1 ) 256 f 
F-'EEI-: ( 162) ) /60 



This will show how quickly you can hit a key. This routine will allow 
you to read time in amounts less than 1 second! In BASIC, time is kept in 
the string TI$ and in a jiffy counter, TL TI starts at "000000" when you 
turn the computer on. The computer uses a "24 hour clock" which means 
that one o'clock in the afternoon is called 1 3:00. You can reset the clock 
to zero by entering TI$ = "000000" or set it to the correct time of day 
(right to the second) by saying, for example TI$ = "041325" for 4 
o'clock, 13 minutes and 25 seconds AM while4 PMis" 161 325". As for 
TI, well it's a counter based on the information in locations 160-162. 
Both TI$ and TI will reset to zero by POKEing these locations with a 
zero. 

ForI= 160TO162:POKEI,0:NEXT 
Try substituting this for line 270 

2 7 P R I N T T 1 / 6 0^ " S E C N D S " 
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Here's an example of using TI$ to produce a clock on your screen. 



100 PRirvlTCHRti ( 147) 

1 10 PGKE^i3280, 1 : poke: ^.3 281 , 1 - P0KE646, 6 

120 PRINT,, "IIGURS". "PlINUTEB", "SECGNUS" 

130 PRINTCHR$ (19) ; 

1 PR 1 m , r 1 1 D$i > "1" I $ , 1 , 2 ) , i'{ I D$ < T' 1 $ , . 2 ') 

)ilD:l-> i ! I 3,, 2) 

130 GGTG130 



TIS and TI are also reserved words used by BASIC. Don't use these 
names for your variables. 

00A3-00A4 163-164 Tempory data area. 
CNTDN 

00 A5 165 Cassette sync, coutdown. 

BUFPNT 

00 A6 166 Pointer tape I/O buffer. 



These are the zeropage memory locations for the RS-232. The 
system's software allows compatability with any RS-232 device (prin- 
ter, modem, etc.). This allows RS-232 programming accessible in 
BASIC through the Kemal routines. These locations are used directly 
by the RS-232 device through the system routines and are not controlled 
by the programmer. See the appendix on the RS-232 in back. During 
cassette or any other serial bus activities, data can NOT be received 
from RS-232 devices. This is how temporary cassette data locations can 
be shared with RS-232 locations. 



INBIT 

00 A7 167 RS-232 input bits/cassette tempor- 

ary. 

BITCI 

00 A8 168 RS-232 input bit count/cassette 

temporary. 
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I«2-It2 



RINONE 
00 A9 

RIDATA 
00 AA 

RIPRTY 
00 AB 



169 



170 



171 



RS-232 flag: Check for start bit. 



RS-232 input byte buffer/cassette 
temporary. 

RS-232 input parity/cassette short 
count. 



SAL 

OOAC-OOAD 
EAL 

OOAE-OOAF 



172-173 



174-175 



Pointer Tape buffer/ screen scrolling. 



When you LOAD or SAVE, the 
computer looks at a part of memory to 
read from or write over. If you or 
your program changes the start of BASIC variable pointers (Iocs. 45-46) 
so you can store more BASIC text, your cassette or disk drive won't be 
aware of the change and will lose some text. Whenever you change 
locations 45-46, and you want to SAVE or LOAD a program on 
cassette. Make sure you POKE these locations with the same values as 
locations 45 and 46. This will make sure you save all of your program. 



CMPO 

OOBO-OOBl 176-177 
TAPEl 

OOB2-OOB3 178-179 



Tape timing constants. 



Pointer: start of tape buffer. This can 
be used as an indirect zero-page jump 
routine in the buffer. 



BITTS 
00 B4 



180 



RS-232 out bit count/cassette temp- 
orary. 



Locations 180 thru 182 act the same as 166 thru 171. 



NXTBIT 

00 B5 1 8 1 RS-232 next bit to send/tape EOT 

(End-Of-Tape) flag. 

RODATA 

00B6 182 RS-232 out byte buffer. 



35 



FNLEN 
00B7 



LA 
00 B8 

SA 
00B9 



183 



184 
185 



Length of current file name. The 
number of characters in the file name 
itself Same as PRINT(LEN 
(FILES)) where FILES is the name 
of your file. 

Current logical file number. 

Current secondary address. In 
BASIC, the secondary address is 
used with the OPEN command. The 
secondary address tells the other 
device what to do after it is opened. 



DEVICE 


DEVICE 
NUMBER 


SECONDARY 
ADDRESS 


DESCRIPTION 


Cassette 


1 


0= Input 
1= Output 
2= Output 


file name 
end of tape 


Modem 


2 





control register 


Printer 


4 or 5 


0= uppercase/ 

graphics 
7=upper/lower 


PRINT text 


Disk 


8 to 11 


2-14 data 

channel 

15= command 

channel 


drive#, file type, 
read/ write 
command 



For example: 



OPEN 1, 4, 7 



This OPENS a channel to the printer (device 4) and tells the printer to 
type upper/lower case letters. 

If you want to write some data about your debts on a cassette tape, 
OPEN 3, 1, 2, ''DEBTS" 
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183 - 197 



tells the computer that file #3 (it could be any number you choose 
between 1 and 255) will be written as a cassette file (the number 1 after 
the 3), and, besides writing the data on the tape, put an "End Of Tape" 
notice (the number 2). The "End Of Tape" (EOT) will tell the computer 
to stop looking for more data on this tape. Only use the EOT mark on 
the last data file or program you put on a cassette. "DEBTS" will be 
the name of the file. 

FA 

OOB A 1 86 Current device number. 

FNADR 

OOBB-OOBC 1 87-1 89 Pointer: current file name. 



ROPRTY 
OOBD 

FSBLK 
OOBE 

MYCH 
OOBF 



189 



190 



191 



RS-232 out parity/cassette temp. 



Cassette read/write block count. 



Serial word buffer. 



CASl 
OOCO 

STAL 
00C1-(X)C2 

MEMUSS 
OOC3-(X)C4 



LSTX 
00C5 



192 



193-194 



195-196 



197 



Tape motor interlock. 



I/O start address. 



Used for temporary storage of in- 
formation while information is load- 
ing from the cassette. 



Current key pressed. The last key 
put into the keyboard buffer. There 
will be a 64 here if a key isn't held 
down. The "stopwatch" program under location 160-162 uses this 
address to see if any key has been pressed. 

If more than 1 key is held down at the same time, the key with the 
highest priority will appear on the screen. 
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This program will give you a list of the keys and their priority. 

100 GET m 

110 IF A$^= " " TIJEM 100 
120 PFUNT PEEK (197) 
130 GOTO 100 



PRIORITY / KEY CHART 



# KEY 


# 


KEY 


# 


KEY 


# 


KEY 


INST 


16 


5 


32 


9 


48 




1 RET 


17 


R 


33 


I 


49 


* 


2 ^ CRSR 


18 


D 


34 


J 


50 


1 


3 n 


19 


6 


35 





51 


CLR 


4 n 


20 


C 


36 


M 


52 




5 f3 


21 


F 


37 


K 


53 




6 f5 


22 


T 


38 





54 


f 


7 1 1 CRSR 


23 


X 


39 


N 


55 


/ 


8 3 


24 


7 


40 


+ 


56 


1 


9 W 


25 


Y 


41 


P 


57 




10 A 


26 


G 


42 


L 


58 




11 4 


27 


8 


43 




59 


2 


12 Z 


28 


B 


44 




60 


SPC 


13 S 


29 


H 


45 


[ 


61 




14 E 


30 


U 


46 


@ 


62 


Q 


15 


31 


V 


47 




63 





NDX 

00C6 1 98 Number of characters presently in the 

keyboard buffer. Normal value: 0. 
Poking this location with a zero 

will empty the buffer. This is very useful in games or other 

applications where keys will be struck quickly. You should always empty 

the buffer before using the GET statement 

100 POKE 193,0 

110 PR I NT "PRESS ANY KEY TO CONTINUE" 
120 GET R^ 

130 IF R$= "" THEN 120 
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TO CONTIMUE^^ 
THEN 120 

The first program checks for any key. The second will continue if only 
one key is pressed. 

RVS 

00C7 1 99 Reverse character switch. Normal: 0. 

The value switches to 18 when 
reversed characters are printed. 

POKE with 1 or 18 before every PRINT to reverse characters. It's 

easier to use the RVS ON and RVS OFF keys. 

INDX 

00C8 200 Pointer end of the logical file for 

INPUT. This location returns the 
screen column number of the end of 

the INPUT record. Unless you use a semicolon or the cursor keys inside 

a string, the computer will put the input question mark in the third column 

of the screen. 



Here are some examples of how to change the position of the INPUT. 
10 INPUT" NAnE";N$ 

10 INPUT" HELLO DO YOU NEED HELP"5N$ 
10 I NPUT" ADDRESS N$ 



LXSP 

00C9-00CA 201-202 Cursor X-Y position at start of 

INPUT. These two bytes store the X, 
Y coordinates respectively where the 

INPUT statement accepts data. POKEing these locations has no affect 

on the screen positioning of INPUT records. 

SFDX 

OOCB 203 Flag: Print shifted characters. Nor- 

mal value is 64. This location will 
show the value listed in 197 when 
characters are printed. 



100 POKE 1^3,0 

110 PR I NT "PRESS 

120 GET R^ 

130 IF R$ <> 
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CURSOR LOCATIONS 



Use these locations to produce a cursor during a GET statement. 



BLNSW 
OOCC 



204 



Flag: Cursor blink toggle. 
0= cursor on 1= cursor off. 



10 POKE204, 0: PGKE207, 0: GETA^ 

20 IFh:^^""THEN 10 

30 PRINTA$; 

40 I FA^^-^CHR^ (13) THEN70 

50 B$-:B$-HAi^ 

60 (3OTC10 

70 PRINTED 



BLNCT 
OOCD 



205 




Timer: Countdown to toggle cursor. 
Normal value: 2. 



GDBLN 
OOCE 



206 



Character under cursor in ASCII. 
Normal value is 32. 



BLNON 
OOCF 



207 



Flag: Last cursor blink on/off. 
Normal value is 0. 



Here's how a sample program to add a cursor might look: 



100 REM — CURSOR WITH GET 

200 B$="" 

300 POKE204 , : PQKE207 , : GET A^ 

400 IF Pi^t-^"" THEN 300 

500 PRINTA^? 

600 IFA$=CHR$ ( 13) THEN 900 

700 B*=B$+-A$ 

800 GOTO 300 

900 PRINTB* 
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204 - 210 



If you want the cursor to blink during a GET, you should have the 
POKEs on the same line as the GET command. If you press return while 
the cursor is on it will stay on the screen as a square. This won't change 
the value of your input. Run the demonstration program and press 
RETURN while the cursor is on. Notice the variable B$ ignores the 
cursor. 

CRSW 

OODO 208 



PNT 

00D1-00D2 209-210 



For example: 

10 POKE 209,0 
20 POKE 210,4 
30 PRINT "HERE I AM" 

will print the string in Line 20 at the top left part of the screen. 

Here's another program example that will show you the screen 
address. 

110 l--;Eii SilREEhi Huur'-.E33 r: 

1 2.0 \\E.l''\ -ft M- <^:- ■¥■: i^. <^ M K <•> <<: * ;f v:; if >> <C ^> -v «: -yv 

.1 Z0 u 

140 REM iAJEhE: SL^REEIi 

150 F"'RINT ClWrt i 14/; 

1 60 :: 

1 70 REEl > > 3 T Lji-;:E CuESEn 

180 R T% CHFE^> ( 29 F4:-ii 

1 90 ;0{M$> ^^^^ ERR 3 \ J 7) ;; EE.El 

2 n 

210 REEi >> El HO IRE 

220 19 Eh ; > BE: RE- EN A 

230 PGR 1^::^ 1 TO 11 



Flag: INPUT or GET from key- 
board. Normal value: 0. 



Pointer Current screen line address. 
POKEing this address can position 
word output on the screen. This is 
similar to using cursor controls, but 
not as easy. 



> 1GV/EMEf.;Tb 
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PNTR 
00D3 



211 



Cursor column on current line. This 
location stores the number of spaces 
on a printed line, just like using the 
BASIC command TAB(X) where X 
would be the number of spaces you 
want to move forward. 



QTSW 
00D4 



LNMX 
00D5 



212 



213 



Flag: Editor in quote mode. means 
you are not in the quote mode. 



Physical screen line length. Normal 
default value: 39. POKEingthis loca- 
tion with a value less than 39 will 
limit printed items on a line to that number by truncation and will NOT 
be wrapped around. 
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210 - 214 



This program is a demonstration. Line 20 makes a 40 character string 
by adding the word to itself 4 times. 



100 REM *** CONCATENATION *** 
110 : 

120 PRINT CHR*<147): REM - CLEAR SCREEN 
130 REM - CONCATENATE A STRING 
140 C*=" BLIZZARD" 
150 C*=C*+C$+Cf +C* 
160 : 

170 REM - TRUNCATE STRING IN LOOP 
180 FOR I = 32 TO 8 STEP -1 
190 : 

200 REM - SHORTEN PHYSICAL LINE LENGTH 
210 P0KE213, I 
220 : 

230 REM - EXAMINE STRING CONTENTS 
240 : 

250 FOR C = 1 TO LEN(C$) 
260 : 

270 PRINTMID* (C*,C, 1 ) ; 
280 : 

290 REM - PAUSE A MOMENT 

300 FOR PAUSE = 1 TO 30: NEXT 

310 : 

320 REM - GET NEXT VALUES 
330 NEXT C 
335 PRINT 
340 NEXT I 



TBLX 

00D6 2 1 4 Current cursor physical line number. 

Normal values: 0-24. POKE this 
location with values from to 255 to 
move the cursor's vertical position. 
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This program will make two words, "SELECT'' and ''LINE" scroll 
up and down over each other. 
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214-254 



00 D7 



215 



Temporary data area. 



INSRT 
00D8 



216 



Flag: Insert mode or the number of 
inserts from the left on a given 
PRINTed line. POKEing with a 
turns off insert mode. 



LDTBl 

OOD9-OOF2 217-242 Screen line link table and also 

temporarily used as a single editor 
buffer in the immediate mode. 
There are two ways of talking about lines in most computers. The line 
you just worked with each time after pressing the RETURN key is the 
logical line. Each line you see on the screen is a physical line. When a 
logical line takes up more than that one physical line, those lines are 
"linked" together and stored in a link table. The computer treats them as 
if they were all one long line. These locations are where those links are 
stored. To demonstrate how links can be used in a program, see the 
'Alternate Screens' example under location 648. 
USER 

OOF3-OOF4 243-244 Pointer Current screen color RAM 

location. This address points to the 
area used to hold the colors for each 
locations on the screen (see 55296 for 
more information). 



KEYTAB 

OOF5-OOF6 



245-246 



Vector Keyboard decode table. 



RIBUF 

OOF7-OOF8 



247-248 



RS-232 input buffer pointer. 



ROBUF 
00F9-00FA 



249-250 



RE-232 output buffer pointer 



FREKZP 

OOFB-OOFE 251-254 Free zero-page space for user pro- 

gram. This is a COMMODORE 
freebee! These locations provide 

four bytes out of the first page of memory so you can write your assembly 

language routines in the zero-page indexed mode. 



HMM-D 
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BASZPT 

OOFF 255 



BASIC temporary data area. 



Locations 256 to 5 1 1 are used by the microprocessor stack. If you're 
programming in BASIC, you won't be using these locations. 



0100-OlOA 256-266 Floating to string work area. 

BAD 

0100-01 3 E 256-318 Tape input error log. 

013F-01FF 319-511 This area is used by the stack and 

other system operations and is un- 
available for other uses. 

BUF 

0200- 1258 51 2-600 System INPUT buffer. This is where 

the information goes when you type 
on the computer. It only stays here 
until the information is needed else- 
where. 



These next 3 locations also aren't that useful to the BASIC pro- 
grammer. They store the parameters for channels OPENed and 
accessed by Kemal routines. These behave in the same way as locations 
1 84- 1 86 except that they store all the file information and not just that of 
the most recently opened channel. They each take up 10 bytes. This is 
the limiting number of files you are allowed open at any one time. More 
on the Kemal is shown in "Addressing the KERNAL". 



LAT 

0259-0262 601-610 Kemal table: Active logical file 

numbers. 

FAT 

0263-026 C 61 1-620 Kemal table: Device number for each 

file. 

SAT 

026D-0276 621-630 Kemal table: Second address each 

file. 
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255 - 644 



KEYD 

0277-0280 631-640 Keyboard buffer queue. This area is 

where characters typed in from the 
keyboard are temporarily stored. If 

characters are POKEd in here and location 198 (which holds the 

number of characters in the buffer) is changed, it will be as if the 

characters were typed from the keyboard. 

The append routine at location 43 uses this location to make the 
computer think something has been typed in. 

MEMSTR 

0281-0282 641-642 Pointer Bottom of memory opera- 

ting system. Normal value is 2048. 

MEMSIZ 

0283-0284 643-644 Pointer Top of memory for operat- 

ing system. Normal value is 40960. 

These are important places! They control the amount of space you 
have to write programs. These values are set by the INPUT/OUTPUT * 
control register (location 1) during power-up and may be different with 
each memory map configuration. Don't confuse these locations with the 
ones that locate parts of the BASIC text (locations 43 thru 56). 

There are lots of pointers used by BASIC to find out where the 
computer stores the different parts of your program. Often, it's good for 
you to know where, too. If you write programs that modify different 
places in memory, this little program could be of help. It keeps track of 
these pointer values. 

100 N T" CHF: ^i ( 14 7 ) 

i 1 DEF F"MT ( X ) ::=i-''EEK; ( X ) 1 256 ^^; ^ EEK: ( X r 1 ; 

1 2 F R 1 N{ J ' ' S ■{■■ H R T l) F P R G i3 R A R ' ' ; F N T : A. Z ) 

130 F'F^:[NT"END OF PRGGRAri AND" 

1 4 R R 1 N ■]•■ ' ' S T A !••< T L) R v A i--'; ]: A B i... ii: 3 ' ' F-' R T ( A- d ) 

150 PRINT"EENGTH GF PRGGF;AN ^^^'^ 

1 6 R R 1 N T i R N T k 4 G ) R H T ( A- :5 ) ) ; B Y J R S ' 

170 PRINT 

:l. 8 R R I R "■{■■ ' ' R H D G R V A R I A B L R B A N D ' 

1 9 R R 1 N T ' ' S T A R J O F A R R A V S ; R N T ( 4 '7 ) 

200 F-'RINT 
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TIMOUT 

0285 645 



Flag: Enable-disable serial IEEE 
T.O. 



COLOR 

0286 646 Current character color code. Nor- 

mal power-up value: 14 (light 
blue). Poke with values from to 
15, the character color code, to see cursor and characters change 
color. Using this location is like using the color keys on the 
keyboard. 

GDCOL 

0287 647 Background color under cursor. 
fflBASE 

0288 648 Bottom of screen memory (page). 

This shows the normal location of the 
screen in "pages", that is 256 byte 
chunks. Normally set to 4. This is the top left comer of the screen. 4 x 
256 = 1024 which is the beginning of the memory area for the screen. 

You can use this information to create alternate screens and switch 
back and forth. This program is a sample of what two screens could look 
like. 
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100 f<em dual screen by jin butt ere i eld 
105 reh translated eor 64 by paul pavelkg 
1 1 p (j k e 5 5 , : p (j p. (:• 5 6 , z 2. : c l r 
120 d:[ml>:(23) 

1 3 O G S U B 4 O z P R I N T C hi R ( 1 ^^l- 7 ) : (:> (j S 1. 1 B 4 O 
140 I-^^^CHP:^ ( 133) 

2 G E T X liji- : IPX^^ I.:^- T hi P N (3 C t S U B 4 U 

2 \ O P R I N T X ;; :G D J 2 O 
400 REM SWITCH 

410 S=PEEK(64Hj 

420 I EB=^^4THENS=^32 : I i 2R s GO j li50u 
4 5 1 P S ^ 2 T H El N S 4 : F 3 <^:> 5 h. □ 1 1) 1:, o 
440 STOP: REN ERROR 

50i:^ }-'i::)|<E64B , S : priH;:E5::'. 272 , i PE PK ^ S ^272 ) AND I S ; 
CRT 



510 EGRJ^ 








520 V:=:pEE 


K ( jH-2 i 7 ^ 


: POK EJ 


•1-2 i 7 


530 LX ( J > 








540 NEXT J 
550 PRINT 


: RETURN 







Enter the program and run it. The screen will momentarily fill with 
random characters. You are actually looking at a bit of memory! The 
screen will clear and return to the original screen. Type in "This is screen 
one Now press the f 1 key on the right side of the keyboard and the 
screen will blank. Type "This is screen two". Press fl and you're back to 
screen one. This is called "Page Flipping". It is used for such things as 
word proccessors and games. 



XMAX 

0289 649 The size of keyboard buffer, nor- 

mally 10. POKEing this with values 
from to 255 controls the 
number of characters the buffer can hold before it loses characters. This 
isn't like location 1 98 . If you POKE a zero here, the buffer can't hold any 
letters. Nothing will print on the screen. Pressing RUN/STOP and 
RESTORE will get you back to normal. 

POKE 649,0 

will disable the keyboard. Use this if you only want someone to use the 
joystick or paddles for input. 
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POKE 649,10 



returns the buffer to the standard size. 



RPTFLG 

028A 650 Flag: REPEAT key used POKE 

650,100: disables repeat of all keys. 
POKE 650,255: enables repeat of 
all keys. POKE 650,0: return to normal operation. Use this location 
to help write graphics programs. As soon as you turn the computer on, 
POKE 650,255 and drawing pictures becomes a lot easier when every 
key repeats. 



KOUNT 
028B 



651 



Repeat speed counter. Normal value: 
4 POKEing with values from to 25 5 
varies the time before keys repeat. 
and 255 will give the longest delay 
times. 



DELAY 
028C 



652 



Repeat delay counter. 



SHFLAG 
028D 



653 



Flag: Keyboard shift key, CTRL key, 
Commodore key ( O ). This location 
shows if these keys are being held 
down. 



Key Pressed 



Value in 653 



Shift 
Commodore ( Qz ) 
CTRL (control) 



1 

2 
4 



If all 3 keys are pressed at the same time the value in 653 would be 7. 
Since it would be unusual for all 3 keys to be down at the same time, 
you could use this as safety stop. 
See how this location changes with, 

10 GET A$: PRINT PEEK (653) : IF === THEN 10 
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44f -4M 



You can use the WAIT command to detect changes in these keys in the 
same fashion as in location 197. Try these, 

1. WATT 653,1,0 => wait for shift 

2. WAIT 653,2,0 => wait for C= key 

3. WATT 653,4,0 wait for CTRL key 

O^; FR I NT " T O Di;:- $:-.T Taj Y T H I S t'-'FvUGRAhl " 
210 PR INT "HOLD DOWN THE SHIF-T, CON TRGL ^ 
2 2 O F F. I N T "AN D I I- i I C:. U N N [ ! D ( i R F F F / b> ' ' 
230 PRINT 

240 PR I NT "TO SAVE PRuGRAh, DO NOTHING.. " 

300 PGR PAUSE^I TG 3u0 

Z 1 I F F E E F. i 6 5 Z ) --^^ 7 T i-l F N 1 

320 NEXT 

330 PRINT "PRGGRAhi BARE" 
34(J END 
lOOO PRINT 

I I F R I N T" " R G G F. A N I F 8 1 R G Y E D ' ' 
1020 NEW 



LSTSHF 
028E 



654 



Last keyboard shift pattern. 



KEYLOG 
028F-0290 



655-656 Vector keyboard table setup. Nor- 

mal value: 60232 



MODE 
0291 



AUTODN 
0292 



657 



658 



Flag: = disable shift key, 128 = 
enable. This doesn't turn the shift key 
off and on, but will show a 128 if 
CHR$(8) is entered and a if 
CHR$(9) is entered. 

Flag: Auto-scroll down = ON. 
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RS-232 LOCATIONS 659-670 



Locations 659-670 will be used if you write programs that need to 
communicate through the RS-232 port to other computers, printers etc. 
Most BASIC programmers won't use these locations. Skip them if you 
wish. If you do use these locations, remember the OPENing of an RS- 
232 channel automatically allocates 512 bytes of memory for two 
buffers which help prevent the loss of data when transmitting or receiving 
RS-232 information. 

If there is not enough free space beyond the end of your program, part 
of your program will be destroyed to make room for the buffers. Be 
careful! 



M51CTR 
0293 



659 



RS-232: 655 1 control register image. 



M51CDR 
0294 



660 



RS-232: 6551 command register 
image. 



M51AJB 
0295-0296 



661-662 



RS-232: Non-stantard BPS(time/2- 
100). 661 and 662 contain the baud 
rate for the start of the bit test during 
the interface activity. This is used to 
calculate baud rate. 



RSSTAT 
0297 



663 



RS-232: The RS-232 status register. 



BITNUM 
0298 



664 



RS-232: Number of bits left to send. 
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ilf-47t 



BAUDOF 

0299-029A 665-666 



RIDBE 
029B 



RIDBS 

029C 



RODBS 
029D 



RODBE 
029E 



IRQTMP 

029F-02A0 



667 



668 



669 



670 



671-672 



RS-232: Baud rate of full bit time. 
Two bytes that are equal to the time of 
one bit cell. (Based on system clock/ 
baud rate) 

RS-232: Index to end of input buffer. 
The byte index to the end of the 
receiver FIFO buffer. 

RS-232: Start of input buffer (Page). 
The byte index to the end of start of 
the receiver FIFO buffer. 

RS-232: Start of output buffer 
(Page). The byte index to the start of 
the transmitter FIFO buffer. 

RS-232: Index to end of output 
buffer. The byte index to the end of 
the transmitter FIFO buffer. 



This temporarily holds IRQ vector 
during INPUT or OUTPUT with a 
cassette. If maskable interrupt is 
generated during tape operation, this location holds the vector address 
until the operation is over before servicing the interrupt. 



ENABL 
02A1 

02A2 

02A3 

02 A4 

02 A5 
02 A6 



673 
674 
675 
676 

677 
678 



RS-232 Enables. 

TOD Sense During Cassette I/O. 

Temporary storage for cassette read. 

Temporary DIIRQ indicator for 
cassette read. 

Temporary for line index. 

PAL/NTSC flag, = NTSC, 1 = 
PAL. 
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02A7-02FF 679-767 Unused. 



lERROR 
0300-0301 



768-769 



Vector Print BASIC error message. 



These address registers from 770 - 779 vector directly into the BASIC 
ROM memory and run these routines to handle important interpreter 
functions. 



IMAIN 

0302-0303 



770-771 



Vector BASIC warm start. 



ICRNCH 
0304-0305 



772-773 



Vector Tokenize BASIC text 



IQPLOP 
0306-0307 



774-775 Vector BASIC text LIST. 

POKE 775,200 will prevent some- 
one from LISTing your program after 
it has been run. To restore LIST 
POKE 775,167. 



IGONE 
0308-0309 

lEVAL 
030A-030B 



776-777 



778-779 



Vector BASIC character dispatch. 



Vector BASIC token evaluation. 



SAREG 
030C 



780 



Storage for 6502 .A register A, 
Accumulator. 



SXREG 
030D 

SYREG 
030E 

STREG 
030F 



781 



782 



783 



Storage for 6502 .X register 



Storage for 6502 .Y register 



Storage for 6502 .SP register .SP, 
Stack pointer. 
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4lf -7t3 



These locations shadow the 6502 internal registers, ^fhey are loaded 
with values prior to a SYS command for passing information on to 
machine language routines or are at the system ROM routines in order to 
achieve non-standard results. Here is an effective method for recording 
and updating the current cursor positions. This can be used as a TLOT 
subroutine. 



10 X = 781 sY^782 : P=^783 s F~'L0T^65520 

20 POKE P,l jREM SET CARRY PLAG 

30 SYS PLOT 5 REM KERNAL PLOT SUBROUTINE 

40 PRINT"GURREh4T CURSOR POSITION ISs" 

50 PR I NT PEEK ( X ) ; PEEK ( Y ) 



1 X=-7a 1 5 Y-::782 : P^-783 s PLnT=^65l520 

20 I NPUT " WR I TE CURSOR POS . ( X , Y ) " ; XP , YP 

30 POKE P,0 sREh CLEAR CARRY FLAG 

40 POKE X.XPsPOKE Y , YP 

5 O S Y S F- L T z F^' E M K E R N A L P I J S U B R U T' I N E- 

/:>0 PR I NT "HI" 



1 A - 7 BO : 7 B 1 i Y ^ 7 8 2 

1 1 F-^ I.... r ^6552 s R E M \< E R N A L R L T S U B . 

1 2 C: H R [J U 1 ^ <£> 5 4 9 O : R E M R. E R N A l... i: H R C:) U T S U B „ 

130 PRINT" " s POKE X ,0 

140 FOR YP OT02I5 

1 5 R R E R , : R E n C l... EAR C A R R Y P t. .. A G 

160 POKE Y,YP 

170 SYB PLOT 

180 POKE A„YP-H65:REM SEND OUTPUT CHAR„ 

j 90 SYS CHROUT 

200 NEXT YP 



1 u A "~ /Ry} 

2 i j S C 6 " > 4 9 s R I::- M R. [ • R N A L S C N R. R Y R. U l" I N E 
i j b E ^ ^> 5 '5 B s K R. M R. R. R N A L G F: J I N R. U I" I N E 

4 S V S SC : SYB GE 

'r-* :i: R R R. R R i A ) < > O I U F: N R R I N 1 C h! R ( F' E R R ( A ) ^ ; 

hC) GO ID 2ij 
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The next three bytes store the information set by the USR(X) 
command in BASIC. Altering their contents may be useful for passing 
arguments in assembly routines. 



USRPOK 

0310 784 This byte stores the 6502 Op-code for 

the jump instruction ( JMP). Normal 
value: 76 (4C-hex). 



USRADD 

031 1-0312 785-786 This is the low and high byte of the 

USR(X) starting address. 



0313 787 UNUSED 

CINV 

0314-0315 788-789 Vector Hardware IRQ vector. 

Default starting address where IRQ 
(interrupt request) routines are ser- 
viced. Normal value: 59953. 



The stop key is in a safe place and isn't usually pressed by mistake. But 
if you don't want people to accidentally stop your program while it's 
running, you can turn off, (it's called "disable"), the RUN/ STOP key 
this way: 

POKE 788,52 

This also stops the clock (TI$ and TI) so don't use this POKE if you need 
the time functions in your program. POKE 788,49 turns on the clock and 
will enable the RUN/STOP key. See location 808 for more information. 

CBINV 

0316-0317 790-791 Vector BRK instruction interrupt 

NMINV 

0318-0319 792-793 Vector non-maskable interrupt. 

Default starting address where the 
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NMI routine is to be service. Normal 
value 65095. 



This is the jump table to the starting address of the above Kemal 
routines within the 8K of Kemal. See in the appendix "Addressing the 
Kemal" for a more detailed explanation of the Kemal operating system. 
You can intercept these vectors for home made machine language 
subroutines. 



lOPEN 
031A-031B 

ICLOSE 
031C-031D 

ICHKIN 
031E-031F 

ICKOUT 
0320-0321 

ICLRCH 

0322-0323 

IBASIN 

0324-0325 

IBSOUT 
0326-0327 

ISTOP 

0328-0329 



794-795 Kemal OPEN routine vector. 



796-797 Kemal CLOSE routine vector. 



798-799 Kemal CHKIN routine vector. 



800-801 Kemal CHKOUT routine vector. 



802-803 Kemal CLRCHN routine vector. 



804-805 Kemal CHRIN routine vector. 



806-807 Kemal CHROUT routine vector. 



808-809 Kemal STOP routine vector. 



POKE 808,239 
will disable the RUN/STOP key without stopping the clock. 

POKE 808,237 
will enable the RUN/STOP key. 
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POKE 808,225 



will disable the RUN/STOP and RESTORE keys. Once your program 
starts, there isn't any way to break out unless the program ends or this 
line, 

POKE 808,237 
is run as part of the program. 



IGETIN 
032A-032B 



810-811 



KERNAL GETIN routine vector. 



ICLALL 
032C-032D 



812-813 



KERNAL CLALL routine vector. 



USRCMD 
032E-032F 



814-815 User-defined vector. How this useful 

address is used is completely up to 
you! Here is an automatic line num- 
bering routine using a defined vector. 



63993 INPUT" <CLR) STARTING LINE #" ; A: INPUT" 
INCREnENT";B:P0KES15,B: PRINT" (CLR) " 

63994 B=A/256:P0KE784, <B-INT (B) ) *256: POKE 
814, BrPRINTA; 

63995 GETA$:PRINTA*; : IFA*< >CHR*(13)THEN639 

63996 PR I NT " G06399S " : F0RA=63 1 T0634 : POKEA , 
145: NEXT 

63997 POKEA ,13: P0KE636 ,13: POKE 198,6: END 

63998 PRINT" (UP) (UP) ": F0RA=1 T03: PRINT 

":next:print" (UP) (UP) (UP) 

63999 A=PEEK (784) -^PEEK ( 81 4 ) *256'+-PEEK (815) 
:G0T063994 



When you run this, the words ''starting line#" appear on the screen. 
Enter the number you want for the first line number of your program. 
1 000 would be a good start. Press return. Next, ''increment" means how 
many numbers between each line. 10 would be good here. Press return 
and your program lines will be automatically numbered. 
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ILOAD 
0330-0331 



816-817 



Kemal LOAD routine vector. Using 
the SYS command and this location's 
address starts LOAD operation on a 
serial device. It automatically 
LOADs the first program. 



ISAVE 
0332-0333 



818-819 



Kemal SAVE routine vector. Same 
as above location except it works with 
the SAVE command. 



0334-033B 



820-827 



Unused. 



TBUFFR 

03 3 C-03 FB 828-1019 Tape I/O buffer. This is the first place 

your cassette programs go when they 
are being loaded. 

It is also storage area #13, 14 and 15 for sprite data. If you have a 
sprite on the screen while loading another program from tape, expect 
your sprite to look strange. This happens because the incoming data from 
the tape changes the data for the sprite. The sprite must be redefined. If 
you use a cassette to save programs, sprite areas #192- 198 would be a 
better place to put them. They will not be changed by using the cassette. 
For information on storing sprites, see the appendix ''Making a Sprite". 

03 FC-0 3 FF 1 020- 1 02 3 Unused. 



VICSCN 

0400-07E7 1024-2023 This is where data must be put to be 

seen on the screen. The computer 
does this automatically. You can do 
this, too by using the POKE command. POKE 1024,8 1 will put a heart 
in the upper left comer of the screen. POKE 55296,7 will make the heart 
turn yellow. Each screen location from 1024 to 2023 has a matching 
color location from 5 5 296 to 5 6295 . To make things you POKE onto the 
screen any color you want and you must also POKE the color locations. 

The screen is made up of 1000 locations, 25 rows of 40 columns. To 
print a specific row and column, use this formula. 



SCREEN DATA AREA 
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POSITION = 1024 + COLUMN NUMBER+40*ROW NUMBER 

Here's a sample program that will print a cyan heart in the 4th row, 
1 5 th column. 

100 PRINTCHR$ ( 147) 

1 10 REM— -1024 IS THE 
120 REi'1 — BEGINNING OR 
130 REM — SCREEN AREA. 
140 3-:l;::)24 

150 REM — 55296 IB THE 

160 REN — S3 TART OR SCREEN 

170 REM — COLOR DATA. 

100 30^^552^6 

l^-vi REM — RUT A CYAN HEART 

200 REN — IN THE 4Th! ROUl 

210 REN — AND 15TH CGLUNN„ 

2 2 R i< esc: + 1 5 4 4 , Z 

2 3 F i<' E 3 + 1 5 -t- 4 i*- 4 3 3 



On the early 64's, any character POKEd to the screen would 
automatically be white. It's been reported that this has been changed to 
blue an newer machines. That means the POKEd characters would be 
the same color as the backround. To make POKEs to the screen visible 
POKE the color location too. Use: 

COLOR POSITION = 55296-hCOLUMN NUMBER-h40*ROW 
NUMBER 



07F8-07FF 2040-2047 Sprite data pointers. 



The sprite pointers tell the sprite-making part of the computer where to 
go to get the information to make a sprite. 



For example: 

POKE 2040,13 

This tells the computer that the data for sprite can be found in the 
13 th block. 
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POKE 2043,192 



This means data for sprite 3 is in the 192nd block. See the appendix 
"How to Create a Sprite" for more information. 

0800-9FFF 2048-40959 Your BASIC programs are stored 

here. You can make the space smaller 
by using locations 43 - 46. 

This handy renumber routine checks the area inside this memory to 
see where the Une numbers are stored. Then it goes through and changes 
all of them to make your program look neater. 

Beware though, it doesn't change the line numbers after a GOTO or 
GOSUB command. You will have to go back and do it by hand. 

To renumber a program you have in memory, use the append routine 
(locations 43-46) or follow these instructions. 

1) Type in POKE43,PEEK(45)-2:POKE44,PEEK(46):CLR 

2) Load in the renumber routine 

3) POKE43,l:POKE44,8 

4) Type in RUN 10000 and press RETURN 

9990 END 

10000 REM RENUriBER i 
1 00 1 Y6~204S - Y7" 1 

1 0020 I FREEK ( V 6-i-3 ) =::6ANDPEEK ( V6+4 ) -39THENEND 
10030 YB^INT ( Y7/256) ^ Y9=^Y7-256-^YS 

:; PCKEY6"^-3, Y9: R0KEY6+4, YS 
1 0040 I FPEEK ( Y6-^-5 ) < >0THENY6-: Y6+ 1 : GGTD 1 0040 
1 5 Y 7 ^ Y 7 -f ■ 1 : Y 6 = Y 6 5 : 6 T D 1 ^^h;:) 2 

The next program is a ''cruncher", that is, it combines many program 
lines into as few lines as possible. This could mean your program would 
run a bit faster and take up less room in memory. It will also make your 
program less readable. If you "crunch" a program, always save an 
expanded version, too. It's much easier to find errors and make 
corrections on an ''un-crunched" program. 
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1 I NPUT " COHB I NE L I NES FROM , TO " ; L , U : C-2049 
t B^256: E-PEEK (45) •i-B-^PEEK (46) -4 

2 LT:-PEEK (Ci-2) -i-Bi^PEEK a: + 3) :PRINTLT; 

3 IFLT<LTHEMC-=PEEK (C) -i-Bit-PEEK ( C4- 1) : G0TG2 

4 I FLT >LTHENPR I NT " L I NE NOT FOUND " " END 

5 LINK^^C: C-=C-H4 

6 a=:pEEK (C) : IFQ< >0THENC-::C-t"l : GGT06 

7 IFPEEK (C^l ) 4-PEEK (C+-2) ^0THENEND 

3 LT::=PEE{< (C t-3) +-B-i^PEEK (C + 4) : PRINTLT^ 

9 I FLT :■ UTHENG-^G-i- 1 : PGKEL I NK , C - 1 NT ( G/ B ) 

^^•B: pgkelinkh- 1 „ c/b: ggtos 

10 POKEC, ASC ( " :: ") :: FGRJ^G-i"lT0E^ Q^PEEK ( J+4) 
1 1 POKEJ, a: NEXT;; E-E-4:: GCT06 



To use this program, first load it in then use the method explained 
above to hide it. Next, load in the program you want to ''crunch". 
Then POKE43,l :POKE44,8 will allow you to see and use the 
crunch program. 

To save yourself time and trouble use the append routine. 

8000-9FFF 32768-40959 VSP (Video/Sound Package) cart- 
ridge ROM => 8192 bytes. 

The ''Video/Sound Package" is a cartridge Commodore plans to 
release that will make programming of sound and sprites easier. The 
penalty is a loss of 8192 bytes of memory. 

AOOO-BFFF 40960-49151 BASIC ROM => 8192 bytes (or 

8KRAM). 

This is where BASIC sits. By using location I , it is possible to have the 
computer temporarily pretend BASIC isn't around any more. Most of us 
will never do something like that, but machine language programs might, 
in order to have more room for longer programs. 

So, in a way, we've come full circle from location to 49 1 5 1 which 
points us back to the beginning again. Our next section embarks on an 
exploration of new territory - the powerful regions of Graphics and 
Sound. 
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GRAPHICS 



If you're not familiar with bytes and bits, please read the very helpful 
section on page 10 to 1 3. Sound and Graphics on the 64 require some 
knowledge of bytes in order to control the power of the machine. 



ne xdUccirndi 




Decimal Loc. Bits 


Description 


noon nooF 




53248 


Sprite X position 


53249 


Sprite Y position 


53250 


Sprite 1 X position 


53251 


Sprite 1 Y position 


53252 


Sprite 2 X position 


53253 


Sprite 2 Y position 


53254 


Sprite 3 X position 


53255 


Sprite 3 Y position 


53256 


Sprite 4 X position 


53257 


Sprite 4 Y position 


53258 


Sprite 5 X position 


53259 


Sprite 5 Y position 


53260 


Sprite 6 X position 


53261 


Sprite 6 Y position 


53262 


Sprite 7 X position 


53263 


Sprite 7 Y position 
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These are magic locations! By changing them you can move up to eight 
sprites across the screen with a FOR/NEXT loop. 

Lx)ok at the description for sprite #0. The term ''X position" means 
the movement from left to right (or right to left) on the screen. ''Y 
position'' is movement up and down. 

Here's a way to make programming easier. By calling the first address 
by a variable name (V) for example, all the other graphic addresses can 
be reached by adding an appropriate number. That makes it easy to 
remember. For example, to move sprite #7 you could use V+14 and 
V+15 instead of 53262 and 53263. 

This program creates a solid sprite. By setting V equal to 5 3248 in line 
140, all the other references to the graphics can be easily written. This 
method of using variable names (like V or S or Al ) for frequently used 
numbers, will also speed up your program. 




220 PGKEV+2i , i 

230 REM — SPRITE HALFWAY ACROSS SCREEN. 

240 PCKEV, 160 

250 REM — SPRITE HALFWAY DOWN SCREEN. 

260 POKEV-f-1 , 150 



The position of sprite is calculated from the top left comer of the 24 x 
2 1 dot area that make up the unexpanded sprite. Even if only one dot is 
used as a sprite, and you happen to want it in the middle of the screen, you 
must still calculate the positioning by starting at the top left comer 
location. 
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DOlO 

53264 (V+16) 



Sprites to 7 X position past position 
256 



Positioning in the horizontal direction is a little complicated. Even 
though you have a 320 pixel wide screen for your sprite, if it moves past 
the 256th pixel from the left (about eight-tenths of the way across the 
screen) you need a ninth bit to describe the sprite's position, because a 
byte can only hold a number up to 255. 

When a sprite crosses the 256 dot "seam", the proper bit in this 
location must be turned on. When crossing back, the bit must be turned 
off. 



For example when sprite moves across the seam to the right: 



POKE V+16, PEEK (V-hl6) OR 1 



If sprite 4 crosses then 



POKE V-hl6, PEEK (V-hl6) OR 16 



To cross sprite back to the LEFT 



POKE V-hl6, PEEK (V+16) AND 254 

Another thing to consider when positioning sprites is that they are 
visible within certain limits even if you want to move them off screen. 
These border parameters vary with dimensions of your display and 
change when your sprites are expanded or unexpanded. 

The best way to find the limits is to create a solid sprite and move it 
back and forth. See the appendix "How To Create A Sprite". 



DOll 





VIC control register. 


7 


register compare: (8 bit) see 53266 


6 


extended color text mode: 1 = enable 


5 


bit-map mode: 1 = enable 


4 


blank screen to border color I 




blank 


3 


select 24/25 row text display: 1 = 25 




rows 


2-0 


smooth scroll to Y dot-position (0-8) 
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Most beginning programmers can skip this location. This description 
will interest intermediate or advanced programmers. Think of this 
register as the main control box for your graphics where each bit acts as 
an on/ofF switch for the graphics modes. 

BIT 6 - EXTENDED COLOR MODE 

In this mode, each character takes on a background color in addition to 
the color of the character itself. Your screen color may be different, so for 
example, you could have a white character with a green background on a 
yellow screen. There is an important limitation in this mode. Since 
memory out of your character code is used to determine this extra 
background color, you are limited to the first 64 characters. See location 
53270 for information on extended color modes. 




If you take a magnifying glass to your screen you'll see the countless 
phosphor dots that comprise the pixels used to fill the screen with color. 
This is the smallest increment of resolution that is available for graphics, 
the bit map mode. The standard bit map mode gives you a 320 horizontal 
dot by 200 vertical dot resolution, with a choice of two colors in each 8 by 
8 bit character. 

ENABLE HIGH-RESOLUTION BIT MAP MODE: 
POKE 53265, PEEK(53265) OR 32 

DISABLE HIGH-RESOLUTION BIT MAP MODE: 
POKE 53265, PEEK(53265) AND 233 

This example of bit mapping is a spiral drawn against a plain 
background. First the screen will go black, then slowly, the screen will 
clear. Then a cyan background is produced and the spiral is plotted. 
When it's finished a black square appears in the top left comer. Press 
RUN/STOP and RESTORE to return to a normal screen. 
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1 000 


F'RINT 


CFIR::!:- ( 147) 










1 n 1 


F'RINT 












1 020 


PRINT 












1 (')?'.("} 


PRINT 












1 040 


PR I NT 


"WMEN SPIRAL CURV 


!:::. 


j. 


•■.'..> 


complf;te, 


1 oso 


PR INT 


BLACK BOX WILL A 


P 




A 


R IN TliE" 


1 060 


PRINT 


"UPPER LTIPT CURNE 


F: 








1 (J 70 


PRINT 












1080 


PR INT 


"PRESS RUN/SIGP A 


N 


D 


R 


EST ORE TO" 


;i O90 


PR I N r 


"RETURN Tu NORMAL 




S'...- 


R 


EEN" 


1 100 


POKE- 


1 98 , :! REM CURSOR 




BL 


A 


CK 


1 1 1 


PR INT 












1 120 


PRINT 












1 130 


PRINT 


"F'RESS ANY KEY TO 




BE 


G 


IN" 


1 1 40 


GP 1 A 


■^■i IF A*^^^"" THEN 


114 


Cj 




1 150 


PR I NT 


CHR:^- (147) 










1 1 60 


RE M ------ 


>PUT BIT MAP AT 81 


7 






1 170 


BASE- 


2-^^-4096 s P0KE53272 , 


p. 


EE 


K 


(53272) 0R8 


1 180 


RE M - 


>ENTER BIT MAP MODE 






1 190 


POKE 


53265, PEEK (53265) 





R3 


2 




i 200 


REM 


>CLEAR'BIT MAP 










1 2 1 


EORI=^^ 


base: 1" B A S E 7 9 9 9 




PO 


K 


EI ,0s NEXT 


1 220 


REM - 


>Sl:i} BACK. AND BO 


R 


DE 


R 


COLORS 


1230 


POKE 


53280,3s REM BORDE 


R 


J 





CYAN 


1240 


PGR I 


-1024 TO 2023 sPOK 


E 


I . 


1 


s NEXT 


1250 


REM • 


> CURVE WILL FILL 


r 


FIE 




SCREEN 


1 260 


PGR S 


0TGi7 STE/30 










1270 


X^150 


H-INT ( 150-*- EXP (-S/2 





) -X- 


S 


I ! I iS/ A ) ) 


1280 


Y:r.90- 


INT { 120^-EXP ( S / 10 




*L 


:G 


s ( s / 2 ) 


1290 


CFI ^■ 


INT ( X /8) 










1 300 


RG 


INT LV / 8 3 










1 3 1 


LJ\| 


Y ANE) 7 










1 :::'i20 


v. •./ 


B A s e: -i - 17 G Z' 2 ^ l; ! 1 -i- 


!_.. 


,N 






1330 


BI 


7 iX AND /; 










1 340 


F-'G}-:::E 


BY , F EEL ( BY ^ Giv (2-' B 


' .1. 








1/^50 


NE y. T 












1 Z60 


FGh:F 


.1 024, 16 










1370 


G G ■[ G 


1 370 











Here's a formula to turn on and off individual pixels on the screen. 
Keep in mind that the screen dimensions are 25 rows by 40 columns. 
That means 1000 (25 X40) characters can be printed on the screen. Lets 
call each one of these places a CHARACTER POSITION. Then this 
formula is used to plot which pixel to turn on. 
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The character position number is found this way: 

CHARACTER POSITION = INT(X/8)*8-hINT(Y/8) 

X and Y are the horizontal and vertical positions of the pixel you want 
to turn on. X will be number between and 320. Y will be a number 
between and 190. 

The row is found by: 

ROW = (Y/8 - INT(Y/8))*8 

Therefore, the byte in which character memory dot (X, Y) is located is 
calculated by, 

BYTE = 1023 -h CHAR*8 -hROW 
The bit to be modified is.. 

BIT = 7 - (X-(INT(X/8)*8) 
Finally, to turn on any bit... 

POKE BYTE,PEEK(BYTE)OR(2t BIT) 
BIT 4 - SCREEN BLANKING 
You can hide anything printed on the screen by: 

POKE 53265, PEEK(53265) AND 239 
The screen will turn the same color as the border. 

POKE 53265, PEEK(53265) OR 16 
will make the screen visible again. 

With this location you could turn off the screen then have 
messages or graphics printed on the screen. Then "pop" the screen into 
view all at once. 

This program will: 

1 ) Blank the screen 
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2) Print a message 

3) Turn the screen back on 



10 PRINTCHR$ a47) 

20 PR I NT "HERE I AM ' " 

30 PR I NT "NOW I'-^LL GO AWAY" 

40 POR PAUSE - i TO 1000:: NEXT 

50 Pa}<E53265, PEEK (53265) AND 239 

60 PRINT 

70 PRINT"! ^N BACK! " 

30 FOR PAUSE ^ i TO 1000:; NEXT 

90 P0KE53265, PEEK (53265) OR 16 

BIT 2-0 - SCROLLING 

You can scroll screen information by moving the screen display in any 
of four directions, moving as slow as 1 pixel at a time or as fast as 8 pixels. 

When you do this, shrink your screen size from 40 to 3 8 columns wide 
or from 25 to 24 rows tall depending on the direction you want to scroll. 
This gives the computer a place to assemble the information before it 
scrolls onto the screen. 

To do truly fine scrolling you'll need a machine language routine. 
Without that routine, scrolling can only be done with text or keyboard 
characters. 

1000 REN -H-^-^^-^if -^^-^^i^-i^--)^ -if -M-*^ 

1010 REN * PROTO SCROLL ROUTINE ^ 
1020 REN **-^e-*^#*-)f ★•M-^-^-jf -it^if -if -ff 
1030 : 

1040 DIN C(8,3):REN CHARACTER MATRIX 
1050 :; 

1060 REN >> SHRINK THE SCREEN 

1070 POKE 53265., PEEK (53265) AND 247 

1030 : 

1090 REN >> STORE CHARACTER INPO. 

1100 POR I ITOa 

1110 POR J - 1T03 

1 120 READ C ( I , J) 

1 130 NEXT J, I 

1140 : 
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1 1 Z R E M . C L E A R S C R E E H / i^J R 1 1" !£ c: U R S □ i"^: 

i 1 6 R R I M 7" C i-i f ^ $ ( 1 4 7 ) ; C j-i R-piZ ) 

ll/'^i ;: 

11S0 REi'l > > riGVE CURSOR TG HOTTOri 

1 I S^i:;:; RGR X 1 TG24 ;; RR I NTCHRv^ (17) :: NEXT 

12:/)0 :: 

1210 RErl >> RDSITIDR RGR 1ST SCROLL < 

1220 RG!<E532S:5, (REEL >: 53203) AND248) -7 
1230 

1240 REM >> PRINT CHARACTER NATRIX :< 

1250 RGR K ^ 1TG8 

1200 RGR L ITGS 

1 27:;:^ 1 R C ( !^ . L ; < TRER RR 1 N TCHR ;^ ^ 1 3 ) ; 

2":"' 5 RR 1 i ore i-i Ro abo c |:;: l._ ) ) ) ; 

1200 RRIiTT" CHR:^ ( 146; ;i 

i 20.V; NEXT L 

7;:;0 RRINT 

Rii-o NEXT K 

2:0 RRINT 

RR0 : 

340 REri : > RRERORN .XN 0--bIT SCROLL < 

T30 RGR: ;XTG7 

X o X; i J x: E 3 Z 2 Z „ ^ R E [Z i ^ \ 3 X: 2 3 ; X* R I j 2 X- B ) - 
X7X^ 

1300 REN r . RAOSE A ;XGriENT - ■ 

1 3 9 Xi i~ G R N - J 3 R ;: E )( J W 

14X)0 NEXT R 
I^^IO 

.L42;X REN : > RETURN 70 RE RE AT 

0430 GO TO 1220 
:L 44X^ 

4 3 R E i1 ; 1 c: H A R A "j- E F: D A T' A ^: < < 

I 400 DATA 32 , 32 32 ., -32 -32 , -32 « 32 32 

1 4 'X D A ] " A Z 2.32,,- Z 2 , - 3 2 3 2 . - X: 2 , - T 2 , 3 2 

1 40X^ DAT' A X^2 » -32 -32 -32 „ -X'2 , -32 „ -~ZZ ^ - 

lAOiX DhTA ZZ .> 32 „ — X-2« —32 m ~ZZ^ — 32« —32,, 31 

1 300 DATA X:2 , 32 -32 , 32 , 32 32 , -32 32 

1 3 1 D A T- A Z 2 „ X: 2 , - X: 2 . Z 2 X: 2 X: 2 - Z 2 . x: 2 

,i 3 X: ^X D T A X 2 „ - 3 2 3 2 „ - 3 2 . X: 2 , • - Z 2.32, - Z 2 
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BIT 3 - 24/25 ROW SELECT 

By POKEing this bit off you will make the screen 24 rows from top to 
bottom, instead of the normal 25. This is used in the fine scrolling mode. 
Half a row is taken from both the top and bottom of the screen. To see this 
work 

POKE 53265, PEEK (53265) AND 247 
To get 24 rows 

POKE 53265, PEEK (53265) OR 8 
will return you to 25 rows. 

D012 

53266 (V-hl8) Read/write raster value for compare. 

Lower 8 bits out of 9 bits (see location 
53265). 

The raster register is a dual purpose register. When you read this 
register it returns the lower eight bits of the current raster position. The 
raster position of the most significant bit is in location 53265. You use 
the raster register to set up timing changes in your display for vertical and 
horizontal band scrolling, mix-moded display (hi-resolufion with char- 
acters) and other kinds of interrupts. 

The changes of your screen should be made when the raster is not in 
the visible postion of the display area. The visible positions are those 
between 5 1 and 25 1 . 

D013 

53267 (V-hl9) Light-pen latch X position. 
D014 

53268 (V-h20) Light-pen latch Y position. 

These locations return the light-pen X, Y positions across the screen 
from to 255. Interrupts can be generated when the pen is triggered. 



D015 

53269 (V+21) Sprite display 

When you want to make a sprite visible, this is the place! 
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Each bit handles a sprite. Sprite is controlled by bit 0, sprite # 1 by 
bit #1 and so forth. 

Here's how to make sprite #4 show on your screen: 

POKE 53269, PEEK (53269) OR 16 

POKE 53269, PEEK (53269) AND (255-16) 

will make sprite #4, and only sprite 4, disappear. 

POKE 53269, PEEK (53269) OR 170 

will put sprites #1, 3, 5, and 7 on the screen. 

POKE 53269, PEEK (53269) AND (255-170) 

will take them off. 



D016 

53270 (V+22) 

7-6 

5 

4 

3 

2-0 



VIC control register 

unused 

unused 

multi-color mode: l=enable (text/ 
map) 

select 39/40 column text: 1 ==40 cols, 
smooth scroll to X position 



Here is another place that is used mainly by advanced graphics users. 
It is an interesting location, but if you program in BASIC only, just take a 
look at the changes you can make in the scrolling Proto. (Location 

53265) 

BIT 4 - MULTICOLOR MODE 

The multi-color mode for text is turned on by: 

POKE 53270, PEEK (53270) OR 16 

Turn it off with 

POKE 53270, PEEK (53270) AND 239 
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532M - 51270 



Normally, each of the 1000 screen positions or "blocks" can have 
only two colors, a background color and a text color. For example, when 
the computer is turned on the background of each block is dark blue and 
the text color is light blue. 

POKEing this location gives you four colors to play with: screen color 
(loc. 53281), and background colors 1 to 3 (loc. 53282-53284). But 
there is a penalty, multi-color mode will work for only the first 64 
characters in the character set, and it needs two bits to describe any of the 
colors. 

Like this: 

•oooo### 

7 6 5 4 3 2 1 



Each letter printed on the screen is really an 8x8 block of pixels with 
some turned on and some off. The ones turned on are the letter you see. In 
the sample row of pixels above, #1, 4, 6 and 7 are on. 

In the multi-color mode they are in pairs. 



• o 




O O 




• 


• • 


7 6 




5 4 




3 2 


1 


A 


B 


C 


D 



The pattern "A" tells the computer to get the color from the back- 
ground #2 (loc. 53283). B gets its information from background #0 
(loc. 5 328 1 ) which is the screen color). C indicates the color comes from 
background #1 (loc. 53282) and D gets its information from the color 
memory area from 55296 to 56295 - different for each screen location. 

Because of this ''two-bit" reading of the data, your resolution will be 
less than normal but you have more color available. 

MULTICOLOR BIT MAP MODE 

This uses two locations (53270 and 53265). The same principles of 
"BIT PAIRS" are used here as in the mode described above. 

Enable this with: 

POKE 53270, PEEK (53270) OR 16 
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POKE 53265, PEEK (53265) OR 32 



Remember, horizontal resolution is decreased. 

BIT 3 - SELECT 38 OR 40 COLUMN MODE 

1 = 40 COLUMN 

POKE this bit to zero to narrow the screen area. That gives you space 
on each side of the screen to assemble the characters before you scroll. 
Doing this will keep the scrolling smooth. 

BIT 2 - FINE SCROLLING 

By adding 

1365 POKE 53270, (PEEK (53270) and 248) + P 

to the program in location 53265, you can make Proto scroll diagonally. 
Again, to do truly fine scrolling you need a machine language routine. 
The example under location 53265, written in BASIC, allows you to 
scroll text and keyboard graphic characters only. 

D017 

53271 (V+23) Sprites to 7 expand sprite 2 times 

(vertically) 

This location will make your sprites twice as large vertically. This has 
a one-to-one correspondence, that is, turning on bit #0 expands sprite 
#0. 

POKE 53271, PEEK(53271) OR 1 
To return sprite # to normal size: 

POKE 53271, PEEK(53271) AND (255-1) 
To expand sprites #7 and #1: 

POKE 53271, PEEK (53271) OR 130 
Also see location 53277. 
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S32?0-S3m 



D018 

53272 (V+24) 



VIC memory control register ' 
video matrix base address (inside 
VIC) 

character dot-data base address (in 
VIC) 



7-4 



3-1 



This location is responsible for the location of both screen memory 
and character memory. 

POKE 53272,23 
will convert the screen display to lower case. 

POKE 53272,21 
will change the screen display back to upper case. 

Another example of the use of this address is seen in location 648, screen 



Screen memory location is controlled by the last four bits (most 
significant nybble) of 53272. To move the screen, use the following: 



flipping. 




SCREEN MEMORY LOCATION 



POKE 53272, (PEEK(53272) AND 15) OR A 



A must be one of the decimal values on this chart. 
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A 


Location 
Decimal 


Hexadecimal 








$0000 


16 


1024 


$0400 


32 


2048 


$0800 


48 


3072 


$0C00 


64 


4096 


$1000 


80 


5120 


$1400 


96 


6144 


$1800 


112 


7168 


$1C00 


128 


8192 


$2000 


144 


9216 


$2400 


160 


10240 


$2800 


1 10 


1 1264 


$2 coo 


192 


12288 


$3000 


208 


13312 


$3400 


224 


14336 


$3800 


240 


15360 


$3 COO 



Normally, A's value is 16, and the screen begins at 1024. 
To create your own character set you modify bits 3 to 1 . 

POKE 53272, (PEEK(53272) AND 240) OR B 
where B is the decimal value from this chart. 



VALUE 
of B 


DEC 


HEX 








$0000-$07FF 


2 


2048 


$0800-$0FFF 


4 


4096 


$1000 -$17FF 


6 


6144 


$1800-$1FFF 


8 


8192 


$2000-$27FF 


10 


10240 


$2800-$2FFF 


12 


12288 


$3000-$37FF 


14 


14336 


$3800-$3FFF 



B is normally set to 4. 
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SI272 - S^S 



See the appendix ''Being an Artist on the Commodore 64" for an 
example of creating your own character set. 

D019 

53273 (V-h25) VIC interrupt flag register (bit=l: 

IRQ) 

7 set on any enable VIC IRQ condition 

3 light-pen triggered IRQ flag 

2 sprite vs sprite collision IRQ flag 

1 sprite vs background collision IRQ fl 

raster compare IRQ flag 

This location is best handled with machine language since the values 
here can change rapidly. 



DOIA 

53274 (V-h26) IRQ mask register l=interrupt 

enabled. 

This location is set the same way as the location above. Unless the 
corresponding bit in the interrupt enable register is set to a 1 , no interrupt 
from that source will take place. Practice your machine code before using 
this! 

DOIB 

53275 (V-l-27) Sprite vs background display priority: 

1 = sprite. 

With this location you can make a sprite pass in front or behind of 
printed characters. 

POKE 53275,2 PEEK(53275) OR 2 

means sprite # 1 will pass behind text or graphics on the screen. 

POKE 53275,7 PEEK (53275) OR 7 

will do the same for sprites #0, 1 and 2. 

POKE 53275, PEEK (53275) AND (255-7) 

will put sprites #0, 1 and 2 in front of the text. 



^fMM-F 
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DOIC 

53276 (V-f 28) 



Sprites 0-7 multi-color mode select: 
1 = M.C.M. 



You can create a sprite with up to 3 colors by POKEing on this location. 

POKE 53276,1 

puts sprite #0 in the multicolor mode. The three color choices come from 
the sprite color locations (53287 to 53294, depending on the sprite 
number you're working with), and the sprite multicolor locations, 53285 
and 53286. 

See the appendix ''How to Create a Sprite" for more information. 



DOID 

53277 (V-h29) Sprites 0-7 expand sprite 2X (hori- 

zontally). 

Like 53271, this is the place used to expand a sprite, horizontally. 
POKE 53277, PEEK (53277) OR 1 
will expand sprite 0, making it twice as wide. 

POKE 53277, PEEK (53277) OR 18 
will expand sprites 4 and 1. Also see location 53271. 



DOIE 

53278 (V-h30) Sprite vs sprite colUsion detect. 

If a sprite is touching another sprite, the bit for that sprite is turned on. 



IF PEEK (V-h30) = 1 THEN ACTION 

is a typical use of this location. It asks if sprite has bumped into another 
sprite. 
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Once you PEEK here, this register resets itself to zero. It's a good idea 
to save the value here by putting it in a variable. 

If PEEK (V+30) = 1 THEN B = 1 

DOIF 

53279 (V+31) Sprite vs background collision detect. 

This works just like the previous location, checking to see if a sprite has 
bumped into some text or graphics. This register also resets to zero after 
being read so if you need to save the value, use a variable. 

If you PEEK (V+3 1 ) and read 1 28 that means sprite #7 has bumped 
into some characters. 

D020 

53280 (V+32) Border color. Normally set to 14 



Poking the numbers from to 1 5 here will change the border color. 
This chart shows the number to POKE to get each color. 



BLACK 

1 WHITE 

2 RED 

3 CYAN 

4 PURPLE 

5 GREEN 

6 BLUE 

7 YELLOW 



8 ORANGE 

9 BROWN 

10 Light RED 

1 1 GREY 1 

12 GREY 2 

13 Light GREEN 

14 Light BLUE 

15 GREY 3 



These numbers are used any time you work with colors. 

53281 (V+33) Background color 0. 

True, this is called a background color, but it is also the screen color. 
This location shows a 6 when the computer is turned on or RUN/STOP 
and RESTORE are pressed. 

This program will show you all the combinations of screen and border 
colors. 
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MEXTA 





53282 (V+34) Background color 1 . 

53283 (V+35) Background color 2. 

53284 (V+36) Background color 3. 

These are the color registers used with the multi-color modes in 
locations 53265 and 53270. POKE the numbers on the colors you want 
to use. See location 53270. 

D025-D026 

53285 (V+37) Sprite multi-color register 0. 

53286 (V+38) Sprite multi-color register 1. 

When the sprite multi-color mode (loc. 53276) has been selected the 
colors in these registers are used in addition to the usual sprite color (loc. 
53287-53294). See the appendix "How to Create a Sprite" for more 
information. 



D027-D02E 

53287 (V-h39) 

53288 (V+40) 

53289 (V+41) 

53290 (V+42) 

53291 (V+43) 



Sprite color. 
Sprite 1 color. 
Sprite 2 color. 
Sprite 3 color. 
Sprite 4 color. 
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53281 - 53294 



53292 (V+44) Sprite 5 color. 

53293 (V+45) Sprite 6 color. 

53294 (V+46) Sprite 7 color. 

These are the color registers for each sprite. 

Each sprite has a "default" color, that is, if you don't POKE a color 
for your sprite, the 64 will automatically give it a color. 



Sprite 


Default Colors 





White 


1 


Red 


2 


Cyan 


3 


Purple 


4 


Green 


5 


Blue 


6 


Yellow 


7 


Grey 2 
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SOUND 



If you are new to sound programming, get ready to be amazed! The 
Commodore 64 has sound capabiHties unheard in other computers. 

You need to use the BASIC commands PEEK and POKE to produce 
sound, so if you're not sure what these commands do, just re-read the 
sections "How to PEEK and POKE" and "BYTES and BITS" on 
pages 6 to 1 3 . 

By calHng the first address by a variable name (S), all other sound 
addresses can be reached by adding an appropriate num.ber. 

10 LET S = 54272 

It is also a good idea to clear the voices by POKEing all the sound 
locations to zero. That keeps unwanted settings out of your program. 




ZOij POKE 



400 NEXT I 

VOICE #1 REGISTERS 

D400 

54272 (S=54272) Voice 1: frequency control, low-byte. 
D401 

54273 (S+l) Voice 1: frequency control, high- 

byte. 

The values to POKE here to produce musical notes are in the note 
table on page 175. 

An example of values to POKE: 
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54272 - 54275 



1 00 PliKF' 



Produces a C note in the 5 th octave. Not every sound you want to 
make will be a musical note. To produce a frequency not on the musical 
note table, use this program. It will give the numbers to POKE in the high 
and low bytes. 



10 PFn:NTc::HR^- ( 14?) 

20 INF'UT"WHAT FREQUENCY DO VGU WANT";F1 
30 F1=^ABS (Fl ) 

40 REM -COMPUTE HIGH BYTE 

^^0 F2^1MT (Fl /256) 

60 REM- COMPUTE LOW BYTE 

70 F3^:^F1 (F2-^256) 

B P R I N T' ' ' 1- K e: l... W B Y f E - ' ' ; F" 3 

V o P R I N 1" ' ' P P. E hi I G H B Y T P - - ; P 2 



Another quality that is given to any frequency of the voice is how 
distinct sound peaks are. This is how you produce tonal textures such as 
vibrato (the vibrating aspect of sound that gives it a singing quality). This 
is done with pulse waveform. The different types of waveforms are 
discussed in the next register. 

In location 54274, POKE a number in the range 0-255. 
In location 54275, POKE a number between 0-15. 

See the "airplane" program in the appendix for an example of pulse 
waveform manipulation. 



D402 

54274 (S-h2) 



Voice 1 : pulse waveform width, low- 
byte 



D403 

54275 (S-h3) 



Voice 1 : pulse waveform width. 

unused 

high-nybble 



7-4 
3-0 
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D404 

54276 (S+4) 



Voice 1: control register. 

select random noise waveform 1 = 

ON 

select pulse waveform 1 =ON 

select sawtooth waveform 1 = ON 

select triangle waveform 1 = ON 

test bit: 1 = disable oscillator 1 

ring modulate osc. 1 with osc. 3 

output 1 = ON 

synchronize osc. 1 with osc. 3 

frequency 1 = ON 

gate bit 1 = start att/dec/sus 

= start release 



7 



6 
5 
4 
3 
2 



1 







This is the place! Here you can decide what kind of note you want to 
create, from the muted sound of a violin to the crash of ocean surf. It all 
depends on the type of waveform you choose. 

Take a look at all the bits in this location. Bits 0, 4, 5, 6 and 7 will be 
used often by everyone. Bits 1 , 2 and 3 are used for advanced sound 
techniques. 

Bit 0: This is the ON/OFF switch of voice one, but it should be used in 
union with one of the waveform bits. When this bit is set to 1 , the attack, 
decay and sustain cycle begins. When it is poked with a 0, the release of 
the note starts. 



will start the Release cycle. 

The waveforms are designed to be used one at a time. You should try to 
add two or more together to experiment. 

Bit 1 : This bit, when turned on, will allow the interaction of voice 1 and 
voice 3, blending both waveforms. To hear this, the frequency of voice 
three should be lower than voice 1 . 



POKE 54276,17 



will begin the A/D/S cycle for the triangle waveform. 



POKE 54276,16 
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54276 ' 



Bit 2: The ring modulation effect creates the sounds of bells or gongs. It is 
also used with voice 3 . In order to hear the ring modulation, voice 1 must 
use the triangle waveform and voice 3 must be set to a frequency higher 
than zero. 

Bit 3: This bit, if turned on, will reset voice 1 until it is POKEd back to 
zero. 

Bit 4: The triangle waveform is smooth and flute-like. The sound is made 
by POKEing this bit and the gate bit on. 

ON: POKE 54276,17 

OFF: 54276,16 




Bit 5: Listen to the brass sound of the sawtooth waveform. 

ON: POKE 54376,33 
OFF: POKE 54276,36 




Bit 6: The pulse waveform can be changed by using location 54275 to 
vary the width of the pulse. You can create sounds from a piano to a 
clarinet. 

ON: POKE 54276,65 
OFF: POKE 54276,64 
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Bit 7: The noise bit. Use this to make rocket blasts to surf sounds. 
ON: POKE 54276,129 



OFF: POKE 54276,128 




D405 

54277 (S-h5) 

7-4 
3-0 



Envelope generator 1: att/dec cycles, 
select attack cycle duration: 0-15 
select decay cycle duration: 0-15 



The attack cycle is one of 4 parts that make up any note played by an 
instrument. In the attack, the volume of the note rises to its highest 
volume. Then it begins to 'decay' or fall in volume to lower level. Decay 
is the second part of a note. 

Some instruments, like a trumpet, have a fast attack. Others, like the 
violin, have a very slow attack! 

Here's an example of how to set both attack and decay. 



100 REM A IS THE ATTACr.; FoATE. 

IIO REM -•- IT cm BE ANY NUMBER EROM 

120 REM TO 15- 

1 30 A ^^-9 

140 EEM D IS THE DECAY RATE.. 

\nO l-vEM - I T CAN BE ANY NUMBER F-RGM 

ISO REM - n TO jY'^ JOu^ 

17 D^^<j 

180 REM - POKE THE AT TAr:K / DECAY 

1 9 n P n [:■: 4. 2 7 "7 ., F E. E K ( 5 4 2 7 7 ) ^-i N D ( J. 6 } 
200 REM - ADD X\W. DECAY NEXT 

2 J. P i J p. P 7. 4 2 7 2 , P P. E P. (54-2 7 : ; 4- D 

This sets a medium attack and decay. 
D406 

54278 (S-f-6) Envelope generator 1: sus/rel cycles. 
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5427* - S4m 



7-4 
3-0 



select sustain cycle duration: 0-15 
select release cycle duration: 0-15 



Sustain and release are the other parts of a sound. When a sound 
decays, the volume falls to the sustain level. The volume stays at this 
level until the release cycle begins. 

Use bits 7-4 to set the sustain level from to 15, zero would be the 
lowest sustain, 15 is the highest sustain. 

The release cycle starts the fall in volume from the sustain level to 
zero. The release cycle follows an exponential curve that mimics the way 
instruments that are blown or bowed actually respond. 

Here's a sample program to produce a single tone. 



100 REM BOUND CM IF" STAROING ADDRESS. 



1 40 RGKL SID-J' I , 

150 NEXT 

1 6 O F< E; M -• b E T T i -l \r I- 1 ]; G i -l E S T V 1 N U. . 
170 RnKESID-i-24 , 15 

180 REM - SET NIGH BYTE AND IJiW BYTE 

190 REM TO RRGDUCE NIDDEE C IN VOICE 

200 REM GNEo 

210 R GEE SID, 34 

220 RGKESIDh- 1 , 75 

230 REM - SET THE ATTACK/DECAY RATE. 

240 REM > A ATTACK; D ^-^^ DECAY 

250 A-^0 

260 D::::^15 

2 7 O p K E: S I D -I- 5 , A -^^ 1 6 + D 

280 REM - SET THE SUSTA I N/REEEASE RATE. 

290 REM > S - SUSTAIN; R - RE CEASE 

300 S^^lu 

310 R^9 

320 ROKES I D-i-6 , 1 6 ^ R 

330 REM CHOOSE THE SAWTOOTH WAVEEuRM 

340 REM - AND TURN 11' GN„ 

350 ROKESID -i-4 . 33 




1 10 SID-54272 
120 R!::-M CEEAR 

1 :•:.<: ^ r-Gi--^ i o to 



i'HE l-vESnYl ER^; 
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360 REM > HOLD THE NOTE A WHILE 
370 FOR PAUSE = 1 TD 129: NEXT 
380 REM - START THE RELEASE CYCLE 
390 POKES 1 04-4,32 



The registers of voices 2 and 3 are handled in the same manner as 
voice 1 . There are a few differences in the voice control registers for ring 
modulation and syncronization. The changes are marked in bold. 



VOICE #2 REGISTERS 



D407-D40D 
54279 (S+7) 

54280(8+8) 

54281 (S-h9) 

54282 (S-hlO) 

54283 (S4-11) 



7-4 
3-0 



54284 (S-fl2) 



6 
5 
4 
3 
2 

1 





7-4 
3-0 



Voice 2: frequency control, low-byte. 

Voice 2: frequency control, high- 
byte. 

Voice 2: pulse waveform width, low- 
byte. 

Voice 2: pulse waveform width. 

unused 

high-nybble 

Voice 2: control register, 
select random noise waveform 
l=ON 

select pulse waveform l=ON 

select sawtooth waveform 1 =ON 

select triangle waveform l=ON 

test bit: l=disable oscillator 1 

ring modulate osc. 2 with osc. 1 

output 1 = ON 

synchronize osc. 2 with osc. 1 

frequency 1 = ON 

gate bit 1 = start att/dec/sus 

0= start release 

Envelope generator 2: att/dec 
select attack cycle duation: 0-15 
select decay cycle duration: 0-15 
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54285 (S+13) 

7-4 



Envelope generator 2: sus/rel 
select sustain cycle duation: 0-15 



D40E-D414 

54286 (S+14) 

54287 (S+15) 



54288 (S+16) 



54289 (S4-18) 

7-4 
3-0 

54290 (S-hl8) 

7 

6 
5 
4 
3 
2 

1 





54291 (S + 19) 

7-4 
3-0 

54292 (S+20) 

7-4 
3-0 

54293 (S+21) 



VOICE #3 REGISTERS 



Voice 3: frequency control, low-byte. 

Voice 3: frequency control, high- 
byte. 

Voice 3: pulse waveform width, low- 
byte 

Voice 3: pulse waveform width. 

unused 

high-nybble 

Voice 3: control register, 
select random noise waveform 
l=ON 

select pulse waveform l=ON 

select sawtooth waveform l=ON 

select triangle waveform l=ON 

test bit: l=disable oscillator 1 

ring modulate osc. 3 with osc. 2 

output 1 = ON 

synchronize osc. 3 with osc. 2 

frequency 1 = ON 

gate bit 1 = start att/dec/sus 

= start release 

Envelope generator 3: att/dec 
select attack cycle duration: 0-15 
select decay cycle duration: 0-15 

Envelope generator 3: sus/rel 
select sustain cycle duration: 0-15 
select release cycle duration: 0-15 

Filter cutoff frequency: low-nybble. 
(bits 2-0) 
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54294 (S+22) 



Filter cutoff frequency: high-byte. 



These locations set the cutoff frequency used by the filters. 

For example, to make 1000 Hz the cutoff frequency: 

POKE 54293,3 

POKE 54294,232 

In other words, (3 * 256) + 232 = 1000. Only numbers from to 7 can 
be POKEd in location 54293. The filtering location at 54296 will look 
here to find the frequency to work with. 



D417 

54295 (S-f-23) Filter resonance/ voice input control. 

7-4 select filter resonance: 0-15 

3 filter external input: 1=YES 0=NO 

2 filter voice 3 output: 1=YES 0=NO 

1 filter voice 2 output: 1=YES 0=NO 

filter voice 1 output: 1 = YES 0=NO 

This is the switch box that turns on and off the filter for the voices you 
select. To turn on the filter if ''V" is the voice number: 

POKE 54295, PEEK (54295) OR 24 V 

Example: 

POKE 54295, PEEK (54295) OR 4 
will turn on the filter for voice 2. 

POKE 54295, PEEK (54295) AND (255-V4 2) 
turns off the filter. 

POKE 54295, PEEK (54295) AND 251 
turns off the filter for voice 2. 
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54294 - 5«2H 



You can filter more that one voice at a time by turning on the proper 
bits. The filter resonance area, bits 4-7, can make the voice sound either 
sharp or dull. There are 1 5 possible resonance settings. To enter them let 
R = the resonance desired. 

POKE 54295, PEEK (54295) + (R * 16) 



D418 

54296 (S+24) 

7 
6 
5 
4 

3-0 



Select filter mode and volume, 
cut-off voice 3 output: l=OFF 
select filter high-pass mode: l=ON 
select filter band-pass mode: =0N 
select filter low-pass mode: l=ON 
select output volume: 
(off) - 15(max) 



The volume of the sound is controlled here. Poke a number between 
and 1 5 . is off, 1 5 is the loudest volume. The volume is set the same for 
all voices, so if you want one voice to sound louder than another, this 
register will have to be rePOKEd every time you change the volume. 

POKE 54296,15 

sets the highest volume. 

Bit 4: You turn on the low pass filter at bit 4 with: 

POKE 54296, PEEK (54296) AND 16 

This passes any frequency lower than the cut off set in location 54293 
and 54294. The frequencies above the cut off are reduced in volume. The 
higher the frequency, the greater the reduction in volume. 

Bit 5: The high pass filter will pass on frequencies higher than the cut off. 
Low frequencies will be lower in volume. 

POKE 54296, PEEK (54246) AND 32 
will start the high pass filter. 

POKE 54296, PEEK (54296) AND 48 
will start both the high pass and low pass filters. This is called a notch 
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reject filter. All frequencies except those near the cut off will pass 
through. 

Bit 6: The bandpass filter is the opposite of the notch reject filter. It will 
pass only frequencies near the cut off. 

POKE 54296, PEEK (54296) AND 64 

will turn it on. 

Bit 7: Voice 3 can be set so its voice can't be sent to a speaker. This is 
useful if you want to use the output of voice 3 in modulation with other 
voices. 

POKE 54296, PEEK (54296) AND 128 
will turn off the output of voices. 
D419-D41A 

54297 (S-h25) A/D converter, game paddle 1 (0- 

255). 

54298 (S+26) A/D converter game paddle 2 (0- 

255). 

Games using paddles must use a machine language paddle routine 
because of the complexity of the conversion from reading these 
locations. See location 56320 for a machine language game paddle 
routine. 

D41B 

54299 (S-h27) Oscillator 3 random number gener- 

ator. 

This location produces a random number from to 255 when voice 3 
is set to the noise waveform. 

D41C 

54300 (S+28) Envelope generator 3 output. 

If voice 3 is turned on, this location will have digital output of the 
A/D/S/R "envelope" for voice 3. This can be added to the filter 
frequency, for example, to produce a range of interesting sounds. 
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54296 - 56319 



D500-D7FF 

54528-55295 RESERVED FOR FUTURE I/O 

EXPANSION 

Commodore has plans for this area... someday. But until they do, this 
would be a great place to put machine language programs. 



SCREEN COLOR AREA 



SCREEN COLOR CONTROL 
RAM 

(ONLY BITS 3-0 USED) 

This area parallels the screen memory area 1024 to 2023. If you are 
POKEing characters to the screen then you must also POKE the color of 
the character here. 

POKE 1024,83 
puts a heart in the top left comer of the screen. 

POKE 55296,2 

will make it a red heart. 

Here are the values to POKE into a color memory location to change a 
character's color: 






BLACK 


8 


ORANGE 


1 


WHITE 


9 


BROWN 


2 


RED 


10 


Light RED 


3 


CYAN 


11 


GREY 1 


4 


PURPLE 


12 


GREY 2 


5 


GREEN 


13 


Light GREEN 


6 


BLUE 


14 


Ught BLUE 


7 


YELLOW 


15 


GREY 3 



This program will fill the screen with hearts, then use all the colors 
available on the computer. 



D800-DBFF 
55296-56319 
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110 REM RANDOM COLOR HEARTS 

120 REM -Jf -Jf ■K--)^-•H•i^■H•-)f-f^-■^t•^^ 

130 :; 

140 REM >> CLEAR SCREEN << 

150 PRINT CHR$(147) 

160 : 

170 REM >> START OF COLOR MEMORY << 

1B0 MIN = PEEK (243) 256*-PEEK ( 244 ) 

190 MAX = MIN 999 

200 : 

210 REM >> POKE HEARTS ONTO SCREN < 

220 FOR H=1024 TO 2023: POKE H, 33:; NEXT H 

230 : 

240 REM >> TOGGLE THROUGH COLORS << 

250 FOR CO--=0 TO 15 

260 : 

270 REM >> POKE COLORS IN WITH 

230 REM >> RANDOM INCREMENTS << 

290 FOR CM-::MIN TO MAX STEP RNDd) ^^ 1^-4 

300 POKE CM, CO 

310 : 

320 REM >> NEXT COLOR TO POKE IN < 

330 NEXT CM. CO 

340 : 

350 REM :> > RETURN TO REPEAT 

360 30 TO 210 
9990 END 
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COMPLEX INTERFACE ADAPTER 
(CIA) #1 



This is a pretty technical area. But in this high-tech world are the 
controls for joysticks and paddles. See location 5632 1 if you want to add 
these routines to the programs you write. 



DCOO 
56320 



7-0 
7-6 
4 

3-0 



PEEK at this address to read the 

joystick at control port 2. 

Data port A: keyboard, joystick, 

paddles 

write keyboard column values for 

keyboard scan. 

select paddle input port: 

01=port A, 10=port B 

joystick 2 fire button: l=fire 

joystick 2 direction (0-15) 



DCOl 
56321 



7-0 

7 
6 
4 

3-0 



PEEK here to read the joystick 
values at control port 1 . 
Data port B: keyboard, joystick, 
paddles and lightpen 
read keyboard row values for key- 
board scan 

timer B toggle/pulse output 
timer A toggle/pulse output 
joystick 1 fire button/lightpen trigger 
(l=fire) 

joystick 1 direction (0-15) 
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These two Icx^ations have a lot of work to do like scanning the keyboard 
to see if a key has been pressed, and checking to see if a joystick, paddle 
or lightpen is in use. 

Plug your joystick into control port 1 and run this program. 

100 FORK^=^0TG10 

110 READDR$(}<) :NEXT 

120 DATA" " , "N" , "S" , "W" , "MW" 

130 DATA"SW" , " " , "E'\ "NE" , "3E" 

140 PRINT"GOING. - „ " ; 

150 GOSUB200 

160 IFDR$ ( JV) =""THEN 130 
170 PRINTDR$ ( JV) ; " " ; 
130 IFFR=16THEN 150 

190 PRINT''-«--M--J*'F-)<-^*I-M-->r*R^^-)^-E*-J^-»<-'' : 6010150 

200 JV=PEEK(56321) 

210 FR=JVAND16 

220 JV=15- ( JVAND15) 

230 RETURN C' 



Moving the joystick will print out the direction you're headed on the 
screen. Press the fire button too. 

Since the keyboard is scanned, these 4 keys will act as a "mock 
joystick": the back arrow (^), the CTRL, 1 and 2. 

Run the program again and try these keys instead of the joystick. Some 
combinations aren't allowed, like trying to go east and west at the same 
time. 

This is the compass rose that shows which direction the joystick is 
pointed. Check these values for movement in your subroutines. 



1 
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56321 - 56322 



A machine language routine is needed to check the paddles because of 
the complexity of reading them. 

The values in each location range from to 255 depending on the 
rotation of the paddles. 



100 


PRINTCHR$ (147) 




110 


C= 12-^^4096 




1 20 


FOR I =01063: READA: PQKEC-M , A: NEXT 




1 30 


SYS C 




140 


P1=PEEK (C-+-257) 




150 


P2=PEEK (C+25S) 




160 


P3=PEEI<(C^-259) 




170 


P4=PEEK (C-+-260) 




180 


W1=PEEK (C-+-261 ) : W2=PEEK (C-+-262) 




190 


PRINTP1,P2,P3,P4 




200 


PRir-4T:PRINT"FIRE A"!iWl,"FIRE B" 


; W2 


210 


FORW=1TO50: NEXT 




220 


PR I NTCHR^ < 1 9 ) GOTO 1 30 




230 


DATA 162, 1, 120, 173,2,220, 141,0, 


193 


240 


DATA 169,192.141,2,220,169 




250 


DATA 128, 141,0,220, 160, 123,234, 


136 


260 


DATA 16,252.173,25,212,157 




270 


DATA 1, 193, 173,26,212, 157,3, 193 


, 173 


230 


DATA , 220 . 9 1 23 . 1 4 1 , 5 , 1 93 






DA Ph 1 V n \b4 ^ .l!-l^2 , 1 6 , 222 , 1 /3 „ i{> 1 '-9 




300 


DATA 1 4 1 , 2 » 220 , 1 73 




3 1 


DATA 1 , 220 1 4 1 a 6 u 1 93 33 96 





When plugged into port 1, the paddles are read at (C4-257) and 
(C4-259) and the fire button is read at (C-f 262). The value in (C4-262) 
will change depending on which fire button is pressed or if both are 
pressed at the same time. 

Paddles in port 2 are read at (C-f-258) and (C-f 260). The fire button is 
(C4-261). It is read the same way indicated above. 

DC02 

56322 Data direction register, port A 
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DC03 

56323 Data direction register, port B 

Normal values for each, 241 

These are the data direction bytes for the control port registers. When 
a bit is set to one, that means that the port is receiving input. A zero turns 
on that bit for output. 

Bit 5 is not counted because line five carries voltage. These data 
direction registers must be POKEd before you set the proper values of 
the control registers. 

DCX)4 

56324 Timer A: low-byte 
DCOS 

56325 Timer A: high-byte 
DCX)6 

56326 Timer B: low-byte 
DC07 

56327 Timer B: high-byte 



Both CIA chips have two powerful 1 6-bit timing devices. They can be 
used to time various waveforms, pulse widths and frequencies for 
internal and external signal generation. These timers can be used 
individually or linked together to expanded timing durations. These 
registers are read in BCD (binary-coded decimal), each nybble describes 
a digit in the timer value. BCD format is faster for I/O operations. 



DC08 
56328 

DC09 
56329 

DCOA 
56330 



Time-of-day clock: 1/10 seconds 



Time-of-day clock: seconds 



Time-of-day clock: minutes 



DCOB 
56331 



Time-of-day clock: hours 
AM/PM flag 
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S6323 - 54333 



These four registers stx)re a real-time AM/PM TOD, time-of-day clock. 
This is another programmable CIA timing feature which, when read, 
returns the respective TOD values. When written to (via setting bit 7 in 
control register 56335), these values latch on the ALARM. This 
programmable alarm allows the CIA to generate an interrupt at a 
specified time. Only the MSB (most significant bit) of the hours register 
is used to specify AM or PM. The values must be latched in one at a time 
starting with the hours register and the clock will not start until the 1/10 
sec. register is set. This ensures that the proper time is specified. 

DCOC 

56332 Synchronous serial I/O data buffer. 

This register stores the values of the serial port which is a buffered, 8-bit 
synchronous shift register system. With every eight clock counts (CNT), 
the shift register deposits a value in this register. The clock counts are 
generated by TIMER A which is also used as a baud rate generator. 
After eight clock counts an interrupt is enabled to send for more data. 
This constitutes a double-buffered I/O system where the micro- 
processor stays one byte ahead of the shift register which stays a byte 
ahead of the serial port buffer. This lets you load new data on the serial 
bus before the shift register clears. 



DCOD 
56333 

7 

4 

3 
2 
1 




CIA interrupt control: read IRQs/ 
write mask (to IRQ) 
IRQ flag (1=IRQ occurred)/set- 
clear flag 

FLAGl IRQ (cassette read/serial 

IEEE SRQ input) 

serial port interrupt 

time-of-day clock alarm interrupt 

timer B underflow interrupt 

timer A underflow interrupt 



This is the register that contains the interrupt and masking information 
for the five sources of interrupts from the 6526. These interrupts are the 
underflow from TIMER A, the underflow from TIMER B, TOD 
ALARM, FLAG and serial port full/empty conditions. When read, this 
location becomes a data register which accepts the interrupts being 
generated. When written to, this location creates a mask for the IRQ line 
which provides selective control over the interrupt system. If bit 7 is 
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zeroed, any mask bit which is on (1) is cleared while off bits are sent 
through. 



DCOE 





CIA control register timer A 


7 


time-of day clock frequency: 




l=50Hz, 0=60Hz 


6 


serial port I/O mode: l=output. 




0= input 


5 


timer A counts: 1 = CNT signals, 




0= system 02 clock 


4 


force load timer A: l=Yes 


3 


timer A run mode: l=one-shot, 




0= continuous 


2 


timer A output mode to PB6: 




l=toggle, 0=pulse 


1 


timer A output on PB6: l=Yes, 




0=No 





start/stop timer A; 1= start, O=stop 



This is the control register for the internal TIMER A and the TOD 
clock talked about under locations 56324 thru 56331. 

(BIT 0) START - This bit enables and disables TIMER A. When an 
underflow condition occurs in the one-shot mode, this bit is auto- 
matically reset. 

(BITl ) PEON - When on, this bit allows the timer output of A to appear 
on Port B. 

(BIT 2) OUTMODE - This allows the ouput of PORT B to either toggle 
(flip on and off) or pulse singly over one cycle duration. 

(BIT 3) RUNMODE - This chooses the one-shot or continuous modes. 
In the one-shot mode, the timer will count down to zero from the value 
latched into it, enable an interrupt, and then stop. In continuous mode, 
the value is re-latched and done again. 

(BIT 4) INMODE - This bit controls which clock is used to decrement 
the timer; either the 02 clock pulses or the external pulses applied to the 
count (CNT) pin. 
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M333 - 5«577 



(BIT 6) SPMODE - This bit controls how TIMER A clocks the serial 
bus. When one, the timer writes out to the serial bus. When zero, the 
serial bus provides input. 

(BIT 7) TODIN - Sets the TOD pin for accurate time. 



DCOF 

56335 CIA control register timer B 

7 set alarm/TOD clock 

1= alarm, 0= clock 

This is the same register for TIMER B with the exception of bits 5 and 
6. These bit pairs are used for timer count transitions and extended timer 
use (using both timers together). 



COMPLEX INTERFACE ADAPTER 
(CIA) #2 

DDOO 

56576 Data port A (serial IEEE, RS-232, 

VIC memory control). 
7 serial IEEE data input 

6 serial IEEE clock pulse input 

5 serial IEEE data output 

4 serial IEEE clock pulse output 

3 serial IEEE ATN signal output 

2 RS-232 data output (user port) 

1-0 VIC chip system memory bank select 



This multi-functional register controls video bank-select, and is the 
control register when an IEEE-488 interface is present on the expansion 
port. This register must be set in correspondence with its data direction 
register (56578). 



DDOI 

56577 Data port B (user port, RS-232) 

7 user / RS-232 data set ready 

6 user / RS232 clear to send 

5 user 
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4 user / RS-232 carrier detect 

3 user / RS-232 ring indicator 

2 user / RS-232 data terminal ready 

1 user / RS-232 request to send 

user / RS-232 received data 

user / RS-232 receive: start-bit (IRQ 



flag) 



Similar to location DEX)0, this register returns values of user PORT B. 
It also handles the RS-232 connection. This register, too, must be 
POKEd in conjunction with its data direction register (56579) to achieve 
results. 



The following registers behave the same as on CIA #1. Both 6526 
chips have identical timing and clock capabilities. 



THE FOLLOWING LOCATION DECRIPTIONS 
APPLY FROM CIA#I 



DD02 
56578 

DD03 
56579 

DD04 
56580 

DD05 
56581 

DD06 
56582 

DD07 
56583 

DD08 
56584 

DD09 
56585 



Data direction register, port A 
Data direction register, port B 
Timer A: low-byte 
Timer A: low-byte 
Timer B: high-byte 
Timer B: high-byte 
Time-of-day clock: 1/10 seconds 
Time-of-day clock: seconds 
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56577 - 57343 



DEX)A 

56586 



Time-of-day clock: minutes 



DDOB 

56587 

DDOC 
56588 

DDOD 

56589 



DDOE 
56590 

DDOF 
56591 



3 
2 
1 




Time-of-day clock: hours 
AM/PM flag (bit 7) 

Synchronous serial I/O data buffer. 

CIA interrupt control: read NMIs/ 
write mask (to IRQ) 
IRQ flag ( 1 => IRQ occurred) / set- 
clear flag 

FLAGl IRQ: cassette read/ serial 

IEEE SRQ input 

serial port interrupt 

time-of-day clock alarm interrupt 

timer B underflow interrupt 

timer A underflow interrupt 



CIA control register A, same as CIA 
1 

CIA control register B, same as CIA 
1 



DEOO-DEFF 
56832-57087 



RESERVED FOR FUTURE I/O 
EXPANSION 



DFOO-DFFF 
57088-57343 



RESERVED FOR FUTURE I/O 
EXPANSION 
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APPENDICES 
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With the COMMODORE 64 you get more than one kind of machine. 
You have the abihty to rearrange sections of memory into eight different 
memory maps. 

Admittedly, this isn't for the novice, but if you are the kind of 
programmer that can make a computer dance, the 64 will do a fine jig. 

There are 8 memory map possibilities. Here's a chart: 

X = Don't Care 
0= OFF 
1 = ON 



Map #1 



8K KERNAL ROM 



4K VO 



4K RAM (BUFFER) 



8K BASIC ROM 



8KRAM 



16K RAM 



USER 



RAM 
16KRAM 



LOWER ADDRESS 
SYSTEM 



I/O expansion (disk) 
I/O expansion (CP/M) 
CIA #2 memory 
CIA # 1 memory 
Color RAM 
SID memory 
VIC memory 



Normal power up memory 
map. It gives the user 38K for 
programming. 



LORAM = 
HIRAM = 1 
GAME= 1 
EXROM = X 
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Map #2 



8KRAM 



4K I/O 



4KRAM 



16KRAM 



16KRAM 



16K RAM 



60K RAM for I/O devices w/o 
system routines. 



LORAN= 1 
fflRAM = 
GAME = 1 or 
EXROM = X 



Map #3 



8K KERNAL ROM 



4K I/O 



4KRAM 



16K RAM 



16KRAM 



16KRAM 



52K for I/O devices and other 
languages including CP/M. 



LORAM=0 
HIRAM = 1 
GAME= 1 
EXROM = X 
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Map #4 



16K RAM 



16K RAM 



16K RAM 



16K RAM 



Full 64K free RAM. No I/O 
operators can be done here. 



LORAM = 
fflRAM= 
GAME = 1 or X 
EXROM = X or 



Map #5 



8K KERNAL ROM 



4K I/O 



4K RAM (BUFFER) 



8K BASIC ROM 



8K ROM CARTRIDGE 
(BASIC EXP) 



16K RAM 



16K RAM 



32K RAM for BASIC user 
with 8K taken up for expansion 
cartridges. 



LORAM= 1 
fflRAM= 1 
GAME = 
EXROM = 
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A 



Map # 6 



8K KERNAL ROM 



4K I/O 



4K RAM (BUFFER) 



8K ROM CARTRIDGE 



8KRAM 



16K RAM 



16K RAM 



40K of user RAM with 8K of 
expansion ROM that does not 
reduce BASIC. 



LORAM = 
fflRAM= 1 
GAME = 
EXROM = 



Map #7 



8K KERNAL ROM 



4K I/O 



4K RAM (BUFFER) 



I6K ROM (CARTRIDGE) 



16KRAM 



16K RAM 



Same as Map #6 except that 
32K is for the user and 16K 
ROM for expansion. 



LORAN= X 
fflRAM= X 
GAME = 
EXROM = 1 
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Map #8 



8K CARTRIDGE ROM 



EOOO 
DOOO 



4K I/O 



4K OPEN 



8K OPEN 



AOOO 



8K CARTRIDGE ROM 



This configuration is used for 
the ULTIMAX video game 
cartridges so that they are com- 
patible on the Commodore 64. 



16K0PEN 



12K OPEN 

1000 



4K RAM 



You have the capabiHty of flipping some of these memory sections in 
and out, freeing that area for other uses such as free RAM for 
programming. Second, you can internally re-locate some smaller 
sections such as screen and character memories (see loc. 648). This 
gives flexibility to several kinds of programming environments. 

For example, locations and 1 in the memory show how to switch the 
3 important ROMS, the KERNAL, BASIC and the Character Gener- 
ator in and out. This is done by the lower three bits of location 1 . This 
location is actually the control registerfor some of the processor's (65 10) 
addressing lines. 

You can even move BASIC into RAM and make your own modi- 
fications to it 

There are other addressing lines monitored by location 1 which are 
connected to the expansion port that you have no control over (at least 
not with software). These lines automatically reconfigure the memory 
map to the specifications determined by what expansion cartridge is in 
use. The cartridge could be a game or word processor, for example. 



no 




ROM MEMORY MAP 

To start out with, the BASIC and KERNAL ROMs share the 64K 
addressing space. This means that while your ROMs are present upon 
turning on the computer, there is still the RAM hidden 'behind' it. When 
you read this area, you get the contents of the ROM routines. If, however 
you write to it your information is stored in the RAM behind it. This is 
convenient if you want to store something in this RAM, but how can you 
get to it? The solution is to flip out any or all of the ROMs present in the 
overall memory configuration using the Commodore 64's impressive 
'bank- switching' feature (see loc. 1). You can free up to 16K ROM 
memory this way and this amount of memory for extra RAM. 



WHAT IS INSIDE THE BASIC 
AND KERNAL ROMS? 



Let's start with the BASIC interpreter which everyone gets auto- 
matically when they turn on their Commodore 64. An interpreter is a 
large library of routines and subroutines which break dovm the BASIC 
commands (tokens) and execute the proper functions in machine code. 

An interpreter is different from a compiler which must methodically 
break down the 'source code' several times (passes) to be reconstructed 
in another binary 'object code' file. An interpreter, while not as efficient 
as a compiler, is certainly a lot easier to use because you don't need 
to wait each time for a compilation process (which can take several 



111 



minutes) each time you debug your program. In addition, the interpreter 
accepts and processes most of the commands that you execute directly 
into the computer in the 'immediate mode'. 

The Kemal is a similar bag of tricks. It is a miniature operation system, 
not as versatile as the BASIC interperter, but built for speed and 
efficiency of operation. This is useful if you need to write machine 
routines and you do not want to re-invent the wheel, that is, constantly 
writing the same input or output routines. Just use the built-in KERN AL 
subroutines. 

When you use BASIC, the computer ''automatically" knows what to 
do with what you wrote and where to go to get the information. The 
KERNAL, however, isn't so automatic. There are certain "calling" 
procedures that must be followed. "Calling" means setting up the 
information the KERNAL routine needs to have before the routine can 
be used. See Commodore's "Programmers Reference Guide" for the 
correct calling procedures for each KERNAL routine. 

The list of locations in this section contain the starting address of all 
the BASIC Interpreter and Kemal operating system routines. They are 
important to know because you can change them or at least alter their 
inputs to non-standard results. You can map all or just a section of these 
ROM routines with this FOR/NEXT loop. For instance, to map 
BASIC into RAM: 

FOR I = 40960 TO 49151 : POKE I,L NEXT I 

That's right. You just POKE an area with its own contents! Remember 
you must take out the ROM when you are done so that you can read the 
RAM. Take the ROM out of operation. You can change the ROM 
routines if you wish. You can modify or even create your own BASIC. 

A few last things to note. First, the sharp-eyed reader will take notice 
of the fact that a number of BASIC ROM routines are in the Kemal 8K 
section. As a result, if you rid yourself of the Kemal, your BASIC will 
not function normally. Second, the ROM memory map locations are not 
all in chronological order. This is to consolidate certain routines which 
are used together. 
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THE KERNAL 



The Kemal is Commodore's name for a table of standard subroutines. 
Everything that goes in or out of the computer uses these routines. 

Kyou write programs in machine language, the list of routines here will 
enable you to use some of the power of the machine instead of writing 
your own. These locations can be called by BASIC using the 'SYS' 
command after loading locations 780-783 with necessary inputs, (see 
program) 

The Kemal is like a wall between you and the inner workings of the 
operating system. These routines are like doors in the wall, allowing you 
to use different parts of the system. Advanced programmers may want to 
cut some windows in the wall to get to some of the subroutines that the 
Kemal uses. Don't do this. Commodore is noted for ROM upgrades, 
which means they will rebuild that wall. They promise to keep the doors, 
but the windows will be gone! 



Here is a brief summary of the Kemal routines. 

Description 



Label 

Hex. Addr. Dec. Loc. 



ACPTR 
FFA5 

CHKIN 
FFC6 

CHKOUT 
FFC9 

CHRIN 
FFCF 

CHROUT 
FFD2 

CIOUT 
FFA8 



65445 



65478 



65481 



65487 



65490 



65448 



Input byte from serial port. 



Open channel for input. 



Open channel for output. 



Input character from channel. 



Output character to channel. 



Output byte to serial port. 



CINT 
FF81 



65409 



Initialize screen. 
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CLALL 
FFE7 

CLOSE 
FFC3 

CLRCHN 
FFCC 

GETIN 
FFE4 

lOBASE 
FFF3 



65511 



65475 



65484 



65508 



65523 



Close all channels and files. 



Close a specified logical file. 



Close input and output channels. 



Get character from keyboard buffer. 



Returns base address of I/O device. 



lOINIT 
FF84 

LISTEN 
FFBl 



65412 
65457 



Initialize input/output. 



Command serial bus device to 
LISTEN. 



LOAD 
FFD5 

MEMBOT 
FF9C 

MEMTOP 
FF99 

OPEN 
FFCO 

PLOT 
FFFO 

RAMTAS 
FF87 



65493 



65436 



65433 



65472 



65520 



65415 



Load RAM from a device. 



Read/ set the bottom of memory. 



Read/ set the top of memory. 



Open a logical file. 



Read/set X,Y cursor position. 



Initialize RAM, allocate tape buffer, 
set screen $0400. 



RDTIM 
FFDE 



65502 



Read real time clock. 
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READST 
FFB7 



65463 



Read I/O status word. 



RESTOR 
FF8A 



65418 



Restore default I/O vectors. 



SAVE 
FFD8 



65496 



Save RAM to device. 



SCNKEY 
FF9F 

SCREEN 
FEED 

SECOND 
FF93 



65439 



65517 



65427 



Scan keyboard. 



Return X, Y organization of screen. 



Send secondary address after 
LISTEN. 



SETLFS 
FFBA 



65466 



Send logical-file, device, secondary 
address. 



SETMSG 
FF90 

SETNAM 
FFBD 

SETTIM 
FFDB 

SETTMO 
FFA2 



65424 



65469 



65499 



65442 



Control Kemal messages. 



Set file name. 



Set real time 'jiffy' clock. 



Set timeout on serial bus. 



STOP 
FFEl 

TALK 
FFB4 



65505 



65460 



Scan stop key. 



Command serial bus device to 
TALK. 



TKSA 
FF96 



65430 



Send secondary address after TALK. 
115 



UDTIM 

FFEA 65514 
UNLSN 

FFAE 65454 



UNTLK 

FFAB 65451 



VECTOR 

FF8D 65421 



Increment real time clock. 

Command serial bus device to 
UNLISTEN. 

Command serial bus device to 
UNTALK. 

Read/ set vectored I/O. 



116 




BASIC ROM ROUTINE 
STARTING ADDRESSES 

This list of ROM addresses was published by Commodore in the 
October/November 1982 issue of their magazine. According to some 
sources, a few of the routines listed here have been changed. Try these 
first to see if what you want to do will work. For detailed information, you 
should contact customer service at Commodore either through regular 
mail or electronic mail on Compuserve. 

One location you should try is 64738. By using the command SYS 
64738, the 64 will reset itself and display the same message as if you had 
just turned on the computer. This is called a 'cold start'. It's just like 
turning the computer off and then on again. Everything is set to its default 
value and any program in the computer is destroyed. This SYS will save 
wear and tear on the switch and the power supply. 



HEX 


DEC. 


ROUTINE 


AOOO 


40960 


ROM control 


AOOC 


40972 


Keyword action vectors 


A052 


41042 


Function vectors 


A080 


41088 


Operator vectors 


A09E 


41118 


Keywords 


A19E 


41374 


Error messages 


A328 


41768 


Error message vectors 


A365 


41829 


Misc. messages 


A38A 


41866 


Scan stack for FOR/GOSUB 


A3B8 


41912 


Move memory 


A3FB 


41979 


Check stack depth 


A408 


41992 


Check memory space 


A435 


42037 


*out of memory* 


A437 


42039 


Error routine 


A469 


42089 


BREAK entry 


A474 


42100 


*ready* 


A480 


42112 


Ready for BASIC 


A49C 


42140 


Handle new line 


A533 


42291 


Re-chain lines 


A560 


42336 


Receive input line 


A579 


42361 


Crunch tokens 


A613 


42515 


Find BASIC line 


A642 


42562 


Perform [NEW] 
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A65E 


42590 


A68E 


42638 


A69C 


42654 


A742 


42818 


A7ED 


42989 


A81D 


43037 


A82C 


43052 


A82F 


43055 


A831 


43057 


A857 


43095 


A871 


43121 


A883 


43139 


A8 AO 


43168 


A8D2 


43218 


A8F8 


43256 


A906 


43270 


A928 


43304 


AQ3R 


43323 




43339 


A96B 


43371 


A9A5 


43429 




43648 


AA86 


43654 


AAAO 


43680 


ARl F 






43R3S 






AR7R 


43899 


ARAS 


43Q41 


ARRF 


43Q67 


ABF9 


44025 


ACX)6 


44041 


ACFC 
















ATh Aft 




APT pri 


44 / o J 


AEF7 


44791 


AEFF 


44799 


AF08 


44808 


AF14 


44820 


AF28 


44840 



Perform [CLR] 
Backup text pointer 
Perform [LIST] 
Perform [FOR] 
Execute statement 
Perform [RESTORE] 
Break 

Perform [STOP] 

Perform [END] 

Perform [CONT] 

Perform [RUN] 

Perform [GOSUB] 

Perform [GOTO] 

Perform [RETURN] 

Perform [DATA] 

Scan for next statement 

Perform [IF] 

Perform [REM] 

Perform [ON] 

Get fixed point number 

Perform [LET] 

Perform [INPUT#] 

Perform [CMD] 

Perform [PRINT] 

Print string form (y.a) 

Print format character 

Bad input routine 

Perform [GET] 

Perform [INPUT#1 

Perform [INPUT] 

Prompt & input 

Perform [READ] 

Input error messages 

Perform [NEXT] 

Type match check 

Evaluate expression 

Constant - Pi 

Evaluate within brackets 
* ^ * 

comma.. 
Syntax error 
Check range 
Search for variable 
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AFA7 


44967 


AFE6 


44790 


AFE9 


45033 


B016 


45078 


B081 


45185 


B08B 


45195 


B113 


45331 


BUD 


45341 


B194 


45460 


B1A5 


45477 


B1B2 


45490 


BlDl 


45521 


B245 


45637 


B248 


45640 


B34C 


45900 


B37D 


45949 


B391 


45969 


B39E 


45982 


B3A6 


45990 


B3B3 


46003 


B3E1 


46049 


B3F4 


46068 


B465 


46181 


B475 


46197 


B487 


46215 


B4F4 


46324 


B526 


46374 


B5BD 


46525 


B606 


46598 


B63D 


46653 


B67A 


46714 


B6A3 


46755 


B6DB 


46811 


B6EC 


46828 


B700 


46949 


B72C 


46902 


B72C 


46892 


B737 


46903 


B761 


46945 


B77C 


46972 


B782 


46978 


B78B 


46987 


B79B 


47003 



Setup FN reference 
Perform [OR] 
Perform [AND] 
Compare 
Perform [DIM] 
Locate variable 
Check alphabetic 
Create variable 
Array pointer subroutine 
Value 32768 
Float-fixed 
Set up array 
*bad subscript* 
*illegal quantity* 
Compute array size 
Perform [FRE] 
Fix-float 
Perform [POS] 
Check direct 
Perform [DEF] 
Check FN syntax 
Perform [FN] 
Perform [STR$] 
Calculate string vector 
Set up string 
Make room for strings 
Garbage collection 
Check salvageability 
Collect string 
Concatenate 
Build string to memory 
Discard unwanted string 
Clean descriptor stack 
Perform [CHR$] 
Perform [LEFTS] 
Perform [RIGHTS] 
Perform [RIGHTS] 
Perform [MID$] 
Pull string parameters 
Perform [LEN] 
Exit string-mode 
Perform [ASC] 
Input byte parameter 
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B7AD 


47021 


B7EB 


47083 


B7F7 


47095 


B80D 


47117 


B824 


47140 


B82D 


47149 


B849 


47177 


B850 


47184 


B853 


47187 


B86A 


47210 


B947 


47431 


B97E 


47486 


B983 


47491 


B9EA 


47594 


BA2B 


47659 


BA59 


47705 


BA8C 


47756 


BAB7 


47799 


BAD4 


47828 


BAE2 


47842 


BAF9 


47865 


BAFE 


47870 


BB12 


47890 


BBA2 


48034 


BBC7 


48071 


BBFC 


48124 


BCOC 


48140 


BCIB 


48155 


BC2B 


48171 


BC39 


48185 


BC58 


48216 


BC5B 


48219 


BC9B 


48283 


BCCC 


48332 


BCF3 


48371 


BD7E 


48510 


BDC2 


48578 


BDCD 


48589 


BDDD 


48605 


BF16 


49818 


BF3A 


48954 


BF71 


47089 


BF7B 


49019 



Perform [VAL] 
Parameters: POKE/WATT 
Float-fixed 
Perform [PEEK] 
Perform [POKE] 
Perform [WATT] 
Add 0.5 
Subtract-from 
Perform [subtract] 
Perform [add] 
Complement FAC# 1 
* overflow * 
Multiply by zero byte 
Perform [LOG] 
Perform [multiply] 
Multiply- a-bit 
Memory to FAC#2 
Adjust FAC#l/#2 
Underflow/ overflow 
Multiply by 10 
+ 1 in floating point 
Divide by 10 
Perform [divide] 
Memory to FAC# 1 
FAC# 1 to memory 
FAC#2 to FAC#1 
FAC#1 to FAC#2 
Round FAC#1 
Get sign 
Perf'orm [SGN] 
Perform [ABS] 

Compare FAC#1 to memory 

Float-fixed 

Perform [INT] 

String to FAC 

Get ASCII digit 

Print *IN. * 

Print line number 

Float to ASCn 

Decimal constants 

TI constants 

Perform [SQR] 

Perform [power] 
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BFB4 


49076 


Perform [negative] 


BFED 


49133 


Perform [EXP] 


E043 


57411 


Series evaluation 1 


E059 


56433 


Series evaluation 2 


E097 


57495 


Perform [RND] 


E0F9 


57593 


?? breakpoints ?? 


E12A 


57642 


Perform [SYS] 


E156 


57686 


Perform [SAVE] 


E165 


57702 


Perform [VERIFY] 


E168 


57704 


Perform [LOAD] 


El BE 


57790 


Perform [OPEN] 


E1C7 


57799 


Perform [CLOSE] 


E1D4 


57812 


Parameters for LOAD/SAVE 


E206 


57862 


Check default parameters 


E20E 


57870 


Check for comma 


E219 


57881 


Parameters for OPEN/CLOSE 


E264 


57956 


Perform [COS] 


E26B 


57963 


Perform [SIN] 


E2B4 


58036 


Perform [TAN] 


E30E 


58126 


Perform [ATN] 


E37B 


58235 


Warm restart 


E394 


58260 


Initialize 


E3A2 


58264 


CHRGET for zero page 


E3BF 


58303 


Initialize BASIC 


E447 


58439 


Vectors for $300 


E452 


58451 


Initialize vectors 


E45F 


58463 


Power-up message 


E500 


58624 


Get I/O address 


E505 


58629 


Get screen size 


E50A 


58634 


Put/ get row/column 


E518 


58648 


Initialize I/O 


E544 


58692 


Clear screen 


E566 


58726 


Home cursor 


E56C 


58732 


Set screen pointers 


E5A0 


58784 


Set I/O defaults 


E5B4 


58800 


Input from keyboard 


E632 


58930 


Input from screen 


E694 


59012 


Quote test 


E691 


59025 


Setup screen print 


E6B6 


59062 


Advance cursor 


E6ED 


59117 


Retreat cursor 


E701 


59127 


Back into previous line 


E716 


59158 


Output to screen 
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E87C 


59516 


Go to next line 


E891 


59537 


Perform [RETURN] 


E8A1 


59553 


Check line decrement 


E8B3 


59571 


Check line increment 


E8CB 


59595 


Set color code 


E8DA 


59610 


Color code table 


E8EA 


59626 


Scroll screen 


E965 


59749 


Open space on screen 


E9C8 


59848 


Move a screen line 


E9E0 


59872 


Sync, the color transfer 


E9F0 


59888 


Set start-of-line 


E9FF 


59903 


Clear screen line 


EA13 


59923 


Print to screen 


EA24 


59940 


Sync, color pointer 


EA31 


59953 


Interrupt - clock etc. 


EA87 


60039 


Read keyboard 


EB79 


60281 


Keyboard select vectors 


EB81 


60289 


Keyboard 1 - unshifted 


EBC2 


60354 


Keyboard 2 - shifted 


EC03 


60419 


Keyboard 3 - COMMODORE 


EC44 


60484 


Graphics/text control 


EC4F 


60495 


Set graphics/text mode 


EC78 


60536 


Keyboard 4 


ECB9 


60601 


Video chip setup 


ECE7 


60647 


Shift/run equivalent 


ECFO 


60656 


Screen In address low 


ED09 


60681 


Send *talk* 


EDOC 


60684 


Send *listen* 


ED40 


60736 


Send to serial bus 


EDB2 


60850 


Serial timeout 


EDB9 


60857 


Send listen SA 


EDBE 


60862 


Clear ATN 


EDC7 


60871 


Send talk SA 


EDCC 


60876 


Wait for clock 


EDDD 


60893 


Send serial deferred 


EDEF 


60911 


Send *untalk* 


EDFE 


60926 


Send *unlisten* 


EE13 


60947 


Receive from serial bus 


EE85 


61061 


Serial clock on 


EE8E 


61070 


Serial clock off 


EE97 


61079 


Serial output *I* 


EEAO 


61088 


Serial output *0* 


EEA9 


61097 


Get serial in & clock 
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EEB3 


61107 


EEBB 


61115 


EF06 


61190 


EF2E 


61230 


EF31 


61233 


EF3B 


61243 


EF4A 


61258 


F8D0 


63696 


F8E2 


63714 


F92C 


63788 


FA60 


64096 


F8BE 


64398 


FB97 


64407 


FBA6 


64422 


FBC8 


64456 


FBCD 


64461 


FC57 


64599 


FC93 


64659 


FCB8 


64696 


FCCA 


64714 


FCDl 


64721 


FCDB 


64731 


FD50 


64848 


FCE2 


64738 


FD02 


64770 


FDIO 


64784 


FCDB 


64731 


FCE2 


64738 


FD02 


64770 


FD15 


64789 


FDIA 


64794 


FD30 


64816 


FD9B 


64923 


FDA3 


64931 


FDDD 


64989 


FDF9 


65017 


FEOO 


65024 


FE07 


65031 


FE18 


65048 


FEIC 


65052 


FE21 


65067 


FE25 


65061 



Delay 1 ms. 
RS-232 send 
Send new RS-232 byte 
No-DSR error 
No-CTS error 
Disable timer 
Compute bit/count 
Check tape stop 
Set read timing 
Read tape bits 
Store tape characters 
Reset pointers 
New character setup 
Send transition to tape 
Write data to tape 
IRQ entry point 
Write tape leader 
Restore normal IRQ 
Set IRQ vector 
Kill tape motor 
Check R/W pointer 
Bump R/W pointer 
Initialize sys. constraints 
Power reset entry 
Check 8K-ROM 
8K-R0M mask 
Bump R/W pointer 
Power reset entry 
Check 8K-R0M 
Kemal reset 
Kemal move 
Vectors 
IRQ vectors 
Initialize I/O 
Enable timer 
Save filename data 
Save file details 
Get status 
Flag status 
Set status 
Set timeout 

Re ad/ set top of memory 
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FE27 


65063 


Read top of memory 


FE2D 


65069 


Set top of memory 


FE34 


65076 


Read/set bottom of memory 


FE43 


65091 


NMI entry 


FE66 


65126 


Warm start 


FEB6 


65206 


Reset IRQ & exit 


FEBC 


65212 


Interrupt exit 


FEC2 


65218 


RS-232 timing table 


FED6 


65238 


NMI RS-232 in 


FF07 


65287 


NMI RS-232 out 


FF43 


65347 


Fake IRQ 


FF48 


65352 


IRQ entry 


FF81 


65409 


Jumbo jump table 


FFFA 


65530 


Hardwire vectors 


FES 9 


65113 


RS-232 receive 


EF7E 


61310 


Setup to receive 


EFC5 


61381 


Receive parity error 


EFCA 


61386 


Receive overflow 


EFCD 


61389 


Receive break 


EFDO 


61392 


Framing error 


EFEl 


61409 


Submit to RS-232 


FOOD 


61453 


Send to RS-232 


FOOD 


61453 


No-DSR error 


F017 


61463 


Send to RS-232 buffer 


F04D 


61517 


Input from RS-232 


F086 


61574 


Get from RS-232 


F0A4 


61604 


Check serial bus idle 


FOBD 


61629 


Messages 


F12B 


61739 


Print if direct 


F13E 


61758 


Get. 


F14E 


61774 


..from RS-232 


F157 


61783 


Input 


F199 


61849 


Get . tap>e/ serial/RS-2 3 2 


FICA 


61909 


Output, . 


FIDD 


61917 


..to tape 


F20E 


61966 


Set input device 


F250 


62032 


Set output device 


F291 


62097 


Close file 


F30F 


62223 


Find file 


F31F 


62239 


Set file values 


F32F 


62255 


Abort all files 


F333 


62259 


Restore default I/O 


F34A 


62282 


Do file open 
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F3D5 


62421 


Send SA 


F409 


62473 


Open RS-232 


F49E 


62622 


Load program 


F5AF 


62895 


*searching* 


F5C1 


62913 


Print filename 


F5D2 


62930 


*loading/ verifying* 


F5DD 


62941 


Save progrram 


F68F 


63119 


Print *saving* 


F69B 


63131 


Bump clock 


F6BC 


63164 


Log PIA key reading 


F6DD 


63197 


Get time 


F6E4 


63204 


Set time 


F6ED 


63213 


Check stop key 


F6FB 


63227 


Output error messages 


F72D 


63277 


Find any tape header 


F76A 


63338 


Write tape header 


F7DO 


63440 


Get buffer address 


F7D7 


63447 


Set buffer pointers 


F7EA 


63466 


Find specific header 


F80D 


63501 


Bump tape pointer 


F817 


63511 


*press play..* 


F82E 


63534 


Check tape status 


F838 


63544 


♦press record* 


F841 


63553 


Initiate tape read 


F864 


63588 


Initiate tape write 


F875 


63605 


Common tape code 



I'-lMM-l 
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THE SERIAL BUS 



The 64 communicates with a printer or disk drive through the serial 
port, the six-pin socket on the back of the computer. This connects the 
peripheral device to the serial "Bus". A "Bus" is a collection of 
communication lines shared by such things as disk drives and printers. 

Imagine youself as a switchboard operator in a train station. Your job 
is to tell when and how the trains are to enter and exit the station. It is 
obvious you must be able to monitor each train's course and in turn, each 
train engineer must notify you of his intentions. Among other things, 
your most critical function is to make sure that trains are not on the same 
track at the same time. The consequences may be disastrous. 

Back to the Commodore 64. It has the role of being the switchboard 
operator of the serial bus. Devices on the serial bus can either 'talk' or 
'listen', that is, send or receive information but never at the same time or 
else all the data would be scrambled. You know how hard it is to 
understand two people speaking at the same time! The 64 not only talks 
and listens but 'controls' who will talk and who will listen. Only the 
computer has this privilege. 

The bus has three input lines that bring in data and three output lines 
that send. Of each three, one line wakes up the device, one line controls 
the timing of data sent on the serial bus, while the third conveys the data. 
Recall the train station analogy. In serial transmission, each car of the 
train is a bit of information. 
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Here's two more points to keep in mind. First, each device on the serial 
bus must be recognized by its device address. That is the second number 
used in the BASIC OPEN statement For example, 

OPEN 1,4 

tells the printer, device number 4, to get ready to do some work. The 
second thing the bus can do is set the device into its selective modes as 
specified by the third number in the OPEN statement. 

OPEN 1,4, 7 

tells the printer to print in upper and lower case letters. 

Using BASIC or machine language you can use the serial bus to 
control other devices. 



127 



THE COMPLEX 
INTERFACE ADAPTERS (CIA) 

THIS CIA is not secret, but it is complex. Ask yourself this question: 
Why is a separate chip required to handle communication tasks? There is 
no obvious answer. Let's start by saying that there are a number of tasks 
that the computer must perform in the right sequence in order to 'talk' and 
'listen' to another device such as the printer, drives and modem 
(modulator-demodulator). Each device shares a number of lines with 
other devices; when one device 'talks' all others 'listen'. These shared 
lines of communication are known as the serial bus. 

Another dilemma facing communications is that these devices may 
speak in different 'dialects' at different rates to one another. Whenever 
communications are not dependent on each other's timing, then a 
method for coordinating their operations are required. This is known as 
'asynchronous communication'. It requires special software and/or 
hardware support. 

COMPLETELY CONFUSED? 

Now, pretend you are the computer. You have data you transmit to one 
of the peripherals, say the printer. But the printer is busily chattering 
away, printing something else that you told it and hasn't finished. The 
printer tells you that it is not ready to print what you have, but to 'wait' 
until it is ready. So you, the computer, put your 'task' on what is known as 
a 'queue' which tells the printer what it has to do next. Meanwhile, you 
periodically ask the printer if it is ready to accept the information you 
want it to process. When the printer responds positively, you can now 
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empty the queue and process your task. This is what is known as a 
'handshaking' protocol and there are several kinds which are constantly 
occuring in a system which interfaces one or more devices. 

This computer has two dedicated CIA chips. They handle the required 
memory locations in the 64K user-accessible memory space which the 
computer or user needs to interrogate and modify. When a device or any 
one of the internal dedicated chips need processing from the 65 1 central 
processor, a signal is sent to one of the CIA chips to request the processor 
to give some of its time to the task. The CIA has the special privilege of 
telling the 65 1 what it can do with its time on certain occasions. So a big 
part of the CIA's task is to process the information from these other 
devices. 
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BEING AN ARTIST 

WITH COMMODORE 64 GRAPHICS 

Often the creative mind has limited channels to express itself. Suppose 
you tried to paint a masterpiece or write a symphony with no prior 
training in those skills and only conventional tools at your disposal. It 
may take years of time and labor to achieve your aim. Lots of us have 
found, in micro-computers, direction in our creativity that we could not 
achieve elsewhere. With the Commodore 64 you may find for yourself a 
whole new dimension beyond paintbrush and manuscript for creating 
graphics and sound. The extentions of your creativity need only conform 
to understanding the practices for constructing programs that sing and 
paint 

Now the key to all of this, or at least the graphics end of things is the 
6567. In other circles U is called the VIC-II chip. If you wondered what 
ever happened to the VIC-I chip, it was put in the VIC-20. Remember 
V.I.C. stands for Video Interface Controller. The VIC-I or 6560 used in 
the VIC-20 is used for both graphics and sound without the powerful 
ability to handle things like Sprites like the Commodore 64 can. There is 
a lot of stuff to play with here, such as the ability to build your ovm 
characters and even write new alphabets. That is only the beginning! You 
can control the destinies of eight different movable objects called Sprites. 
You control how they move, what they do when they hit other objects, or 
what they do when they hit each other. 



LETS GET TECHNICAL FOR A MOMENT... 

First of all, the VIC-II is, in fact, a two chip processor. The companion 
cFiip is the 6566 chip. About the only difference between them is how 
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they access the system's address busses. Other than that, normal 
operations between the two are completely transparent to the system and 
for all practical purposes they can be considered as a single functional 
unit The VIC-II, like other dedicated graphics chips on the market, has 
direct memory access (DMA) to the central processor (6510). This 
means that when the VIC-II needs to get something done it has to ask the 
65 10 if it can use the system's 8-bit bi-directional data busses to convey 
information to the 64 K of RAM The 65 10 has to give up machine cycles 
to comply with the request, thereby slowing down processing. Inci- 
dentally, the user can disable the DMA to speed up the system's proces- 
sing through screen blanking (see location 53265) and disable the 
interrupts along the address busses so that graphics processing won't 
interfere with the rest of the system (see location 56334). For those who 
insist on seeing a simple hardware overview: 



PIN CONFIGURATION PIN CONFIGURATION 
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(Multiplexed addresses in parentheses) 
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In addition, the chip takes care of test display, high resolution 
graphics, sprites, sprite priorities and sprite collision direction. All of the 
Commodore 64 's graphics are available in multi-color mode which give 
your display objects more colors to chose from. A rule of thumb is what 
you gain in colors you lose in resolution. That's because the 8 bits in the 
byte are read in 'bit pairs' 



• 

7 6 




O O 
5 4 




O • 

3 2 




• • 

1 


A 


B 


C 


D 



A gets color from location 53281 - the screen color. 

B gets color from location 33282 - background #1 color. 

C gets color from location 53283 - background #2 color. 

D gets color depending on where it is located on the screen. This comes 
from the color RAM area 55296 to 56295. 
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PROGRAMMING 

VIDEO BANK SELECTON 

With the computer, we think that all the memory is available at the 
same time. 64K is 64K, right? To the VIC-II chip's addressing Hnes, 
only 16K chunks of memory can be considered at any one time. There 
are four sections of 1 6K banks to choose from when changing the starting 
locations. The VIC-II chip, however does not have control over what 
section of memory it sees. This is accomplished by the 6526 Complex 
Interface Adapter #2 (CIA #2). Two bits used out of control PORT A 
are used to select the start address location. Here is how to modify these 
bit selections: 

To change video bank: 

POKE 53272, PEEK (53272) AND 15 OR A 



The values of 'A' control the following values: 



Value 






Starting 


VIC-II 


Of A 


Bits 


Bank 


Location 


Chip Range 





00 


3 


49152 


($C000-$FFFF)* 


1 


01 


2 


32768 


($8000-$BFFF) 


2 


10 


1 


16384 


($4000-$7FFF)* 


3 


11 








($0000-$3FFF) 










(DEFAULT VALUE) 



♦NOTE: The Commodore 64 character set is not available to the VIC-II 
chip in BANKS 1 and 3. 



133 



The only part of graphics memory that is not relocatable is screen 
color memory. It always starts at location 55296 ($DBE7) and ends at 
location 56295 ($DBE7). Actual color is determined by the nybbles in 
each color byte since a nybble can describe sixteen colors. Whenever a 
character is POKEd onto the video matrix with the proper screen color 
code (see screen color code table at the end of this section), its color is 
determined by the values in the color memory. 



PROGRAMMABLE CHARACTERS 

Perhaps one of the most versatile techniques in modem graphics 
programming is the ability to create custom characters for any one 
variety of purposes. With this technique you can create an entirely new 
character set, different from the one found in the character generator 
ROM. Think of the possibilities! An entirely new alphabet, or font, of 
special characters used for building certain kind of displays. Fonts are 
particularly useful for writing arcade style games or creating several 
characters to animate. Fonts are a kind of portfolio for the re-defined 
character information employed in these more advanced programming 
techniques. 

A PROTO EXAMPLE 

This example changes 4 characters: the 2, <, 7 and = into Prototype. 
The steps followed here will work with any characters you want to 
modify from the standard character set 

The first step is to turn off the keyboard and all input and output Then 
move the characters from ROM (Read Only Memory) to RAM 
(Randam Access Memory - memory you can modify) so you can make 
the changes. Lines 1040 to 1260 do just that 

1040 REM >> TURN OFF I/O, BRING IN ROM 
1050 RCKE 56334, REEK (56334) AND 254 
1060 ROKE l.REEKd) AND 251 

1070 'n 

1080 REN >> NO- OF BITS FROM CHAR. ROM 
1090 FOR 1=0 TO 63 
1100 :: 

1110 REM >> RANGE OF BYTES /CHARACTER 
1120 FOR J=0 TO 7 
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1 1 Z0 : 

1140 REM >> COF-Y BYTE OVER INTO RAH << 

1 1 50 POKE 1 223a-H I J , PEEK ( 5324S+ 1 ^-S-^ J ) 

1160 : 

1170 REM NEXT BYTE OR CHARACTER << 

1 130 NEXT J, I 

1190 : 

1200 REN >> TURN ON I/O AND RON OUT << 

1210 POKE 1, PEEK(1)UR4 

1220 POKE 56334, PEEK (56334) OR 1 

1230 : 

1240 REN >> RESET CHARACTER NENORY 

1250 REM >> POINTER TO 1223S << 

1260 POKE 53272, (PEEK(53272) AND240^ -H12 

1270 : 



Next, modify the character. Each one is stored in 8 bytes. That is the 
job of these lines. 

1280 REN NESTED LOOPS STORE 

1290 REM >> BYTES PER CHARACTER << 

1300 FOR CHAR = 60 TO 63 

1310 FOR BYTE ^ TO 7 

1320 

1330 REM ■>> READ R'E-DEFI NED DATA < < 

i34!:-:i REE AD NUN 
1350 :: 

1360 REM >> STORE NEW DATA INTO CHAR- < 
1 370 POKE 1 2233-H ( S-^^CHAR ) +B YTE , NUM 

1330 : 

1390 REM >> NEXT BYTE OR NEXT CHAR- << 

1400 NEXT BYTE, CHAR 

1410 : 



This puts the redefined character on the screen. By pressing any key 
the characters will change back to the standard character set 

1420 REM >> PUT RE-DEFINED CHAR ON << 
1430 PR I NTCHR$ ( 1 4 7 ) TAB ( 255 ) CHRi^ ( 60 ) ; 
1440 REM >> USER PRESSES KEY TO SEE << 
1 450 PR I NTCHR* (61) TAB ( 55 ) CHR$ ( 62 ) CHR* ( 63 ) 
1460 REM >> NORMAL CHARACTERS << 
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1470 GETA*:IF A*="" THEN GOTO 1470 
1480 : 

1490 REM >> RESET CHAR MEM POINTER << 
1500 REM >> TO NORMAL << 

1510 POKE 53272,21 
1520 : 

This last section is the data necessary to change the standard 
characters into Proto. 

1530 REM » NEW CHAR. DATA << 

1540 DATA 7,7,30,30,127,127,31,31 
1550 DATA 224,224,120,120,225,225,248,248 
1560 DATA 24,24,24,24,24,24,102,102 
1570 DATA 24,24,24,24,24,24,102.102 
1580 END 

Character Graphics is a powerful tool for programmers who want to 
customize programs. It gives added dimension to games, too. 
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ASCII and CHR$ CODES 



PRINT CHRS 


PRINT 


CHRS 


PRINT 


CHRS 


PRINT 


CHRS 





RED 


28 


8 


56 


T 


84 


1 


CURSOR 
RIGHT 


29 


9 


57 


U 


85 


2 


GREEN 


30 




58 


V 


86 


3 


BLUE 


31 




59 


W 


87 


4 


SPACE 


32 


<Z 


60 


V 
A 


OO 


WHITE 5 




33 




61 


Y 




6 




34 


I> 


62 


Z 


90 


7 

DISABLES 

SHIFT 38 

ENABLES f2kQ 
SHIFT IS^ 


# 
$ 

% 


35 
36 
37 


@ 

A 


63 
64 
65 


r 

[ 

£ 

] 


Qi 

y I 
92 
93 


10 


& 


38 


B 


66 


T 


94 


11 




39 


C 


67 




95 


1 2 


( 


40 


U 


CO 

DO 


Q 


yo 


RETURN 13 


) 


41 


E 


69 


fin 


97 


LOWERCASE 

15 


* 


42 
43 


F 
G 


70 
71 


m 
LU 

H 


98 
99 


16 


• 


44 


H 


72 


□ 


100 


DOWN ' ' 




45 


1 


73 


LJ 


101 


REVERSE ON 1 8 




46 


J 


74 


1 — 1 


102 


HOME 1 9 


/ 


47 


K 


75 


fin 


103 


DELETE 

21 




1 


48 
49 


1 

L 

KA 
M 


7d 

1 I 


LU 


104 
105 


22 


2 


50 


N 


78 




106 


23 


3 


51 





79 




107 


24 


4 


52 


P 


80 


□ 


108 


25 


5 


53 


Q 


81 




109 


26 


6 


54 


R 


82 





110 


27 


7 


55 


S 


83 


n 


111 
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PRINT CHR$ 

112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 

ORANGE 1 29 
130 
131 



PRINT CHR$ 



PRINT CHR$ 



PRINT 



□ 

m 

□ 

□ 

□ 



fi 

f3 
f5 
f7 
f2 
f4 
f6 
f8 



132 
133 
134 
135 
136 
137 
138 
139 
140 



RETURN 141 

SWITCH TO 
UPPERCASE '^^ 

143 

144 
145 
146 
147 
148 
BROWN 1 49 
LT. RED 1 50 
GREY 1 



BLACK 

CURSOR 
UP 

REVERSE 
OFF 

CLEAR/ 
HOME 

INSERT 
DELETE 
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GREY 2 



GREY 3 

PURPLE 

CURSOR 
LEFT 

YELLOW 

CYAN 

REVERSE 
SPACE 



H 

□ 
□ 
□ 

□ 

B 

□ 

ffl 



52 




172 


53 


TO 


173 


54 


bu 


174 


55 




175 


56 


Q 


176 


57 


H 


177 


58 


S 


178 


59 


B] 


179 


60 


D 


180 


61 


C 


181 


62 


□ 


182 


63 


! 1 


183 


64 


n 


184 


65 


□ 


185 


166 


n 


186 


67 




187 


68 


H 


188 


69 


a 


189 


70 


1 1 


190 


71 


s 


191 



CODES 
CODES 
CODE 



192-223 
224-254 
255 



SAME AS 
SAME AS 
SAME AS 



96-127 

160-190 

126 
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SCREEN DISPLAY CODES 



SETl 


SET2 


POKE 


SETl SET2 


POKE 


SETl 


SET2 


POKE 


(a) 







£ 


28 


p 








A 




1 


1 
J 




Q 




O / 


B 


b 


2 


1 










C 


c 


3 




31 






59 


D 


d 


4 


SPACE 


32 


< 




60 


E 


e 


5 


! 


33 


_ 




61 


F 


f 


6 




34 


> 




62 


G 


g 


7 


# 


35 


? 




63 


H 


h 


8 


$ 


36 


B 




64 


1 


i 


y 


% 


o / 


1 ' 1 




65 


J 


j 


1 u 


& 


oo 


m 


B 


66 


U' 

r\ 


K 


1 1 




jy 


a 

LZi 


c 


67 


1 

L 


1 
1 


1 ^ 


( 


ATI 




D 


68 


M 


m 


13 


) 


41 


1 — 1 


E 


69 


N 


PI 


14 




42 


□ 


F 


70 





n 


1 ^ 




43 


□ 


G 


71 


P 




16 




44 


□ 

1 LI 


H 


72 


Q 


a 


17 




45 


□ 

1 — I_J 


1 


73 


R 


r 


18 




46 


□ 

\ 1 


J 


74 


S 


s 


19 


/ 


47 


□ 

1 i 


K 


75 


T 

1 


*■ 
I 


on 





48 


□ 


L 


76 


u 


u 


21 


1 


49 




M 


77 


V 


V 


22 


2 


50 





N 


78 


w 


w 


23 


3 


51 


n 





79 


X 


X 


24 


4 


52 


□ 


P 


80 


Y 


y 


25 


5 


53 


m 


Q 


81 


z 


z 


26 


6 


54 


□ 


R 


82 


[ 




27 


7 


55 


H 


S 


83 
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SETl SET 2 


POKE 


SETl 


SET 2 POKE 


SETl 


SET 2 POKE 


C 


T 


84 




99 


3 


114 




85 


□ 


100 




115 




V 


86 


□ 


101 


C 


116 




D 


w 


87 




102 


c 


117 


\± 


X 


88 


□ 


103 


□ 


118 


□ Y 


89 




104 


n 


119 


[S 


z 


90 


c 


^ 105 


n 


120 


EB 




91 


□ 


106 


y 


121 




E 




92 


[B 


107 


□ 


122 




m 


93 


a 


108 


E 


123 




TT 




94 


Q 


109 


[5 


124 


a 




95 


□J 




tLl 


1 ilD 


SPACE 


96 


□ 


111 




126 






97 


Da 


112 


S 


127 









98 


H 


113 
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HOW TO CREATE SPRITES 

Sprites are special movable objects you can design yourself. After the 
design work - and it is a bit of work - the computer will help you easily 
move them, check for collisions with other sprites, with text or other 
graphics, and even keep track of priorities, in other words, which sprites 
will pass in front of the others. 



DESIGN THE SPRITE 

A sprite is designed using 63 bytes of memory - 2 1 rows with 3 bytes 
in each row. With eight positions in each byte, you have 24 (3 times 
8) spaces in each row. 

Mark off a 24 x 21 section of graph paper. This is the grid needed to 
represent your sprite. 



Row 1 
Row 2 
Row 3 
Row 4 

coot 



Now draw lines dividing the grid into 3 equal columns of 8 squares 
each. 
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These markings are used later to calculate the byte values needed for 
the data statements. The first row and first column looks like this: 



128 64 32 16 8 4 2 1 128 64 32 16 8 4 2 1 128 64 32 16 8 4 2 1 



Row 1 


















































Row 2 


















































Row 3 


















































Row 4 










































































N 





















Of course, all the 62 other pieces of the graph look like this, too. To 
turn on the parts of the sprites marked, you would write a data statement 
for each of the 63 bytes needed. To have a first row that looked like this 



128 64 32 16 8 4 2 I 128 64 32 16 8 4 2 1 128 64 32 16 8 4 2 1 







1 






i 








i 






































































































































































































1^ 











would need a DATA statement like this: 



DATA 63,255,192 



Finish designing your sprite then calculate the value of the 63 bytes 
needed for each sprite. 



STORING THE SPRITE IN MEMORY 

After building the sprite and calculating the DATA statements, you 
must POKE the data into memory. You can put sprites safely in the 
locations shown on the following chart Other places can be used, 
too, but require that you reserve space in the computer. See locations 
55 and 56 for a routine to do this. 
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LOCATION 


DATA 




POINTER 


832 


13 


896 


14 


960 


15 


12288 


192 


12352 


193 


12416 


194 


12480 


195 


12544 


196 


12608 


197 


12672 


198 



If you use a cassette to store programs, then remember location 13,14 
and 1 5 are used by the cassette for temporary data storage when loading 
or saving programs. The two operations will cause the sprite data stored 
there to be changed. The sprites should be redefined by reading the spite 
data again and rePOKEing it into memory. 

Use a FOR/NEXT loop to POKE in the data; for example; 

100 REh -if* L = THE START OF SRITE DATA 

110 L= 12288 

120 FOR I = TO 62 

130 REM SD = SPRITE DATA ELEMENT 

140 READ SD 

150 POKE L+I,SD 

160 NEXT 

170 REM SAMPLE DATA 

180 DATA 63,255,192,35,170,85,120, ETC 
190 : 
200 : 

SETTING THE SPRITE POINTERS 

Each sprite has a location that tells the computer where to go to get 
the data necessary to put the sprite on the screen. The sprite pointers 
are locations 2040 to 2047 and they point for sprites to 7, 
respectively. If you POKE for information for sprite in location 
960 then: 
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POKE 2040,15 



See the chart above to find the right data pointer. If you don't want to 
use the chart, just divide the location address by 64 to get the pointer 
number. 

960/64 = 15 

If you want 4 sprites to look exactly the same, just POKE the data 
once and set the pointers for the 4 sprites to the same area. This makes 
sprites 0, 1 , 2 and 3 look exactly alike. 



100 FOR I = 2040 TO 2043 
110 POKE I, 15 
120 NEXT I 



CHOOSING THE COLOR 

Once you have the sprite data in memory then decide on the color the 
sprite will be. Each sprite has a default color, that is, a color already set 
by the computer. If you want, choose a color from this chart and POKE it 
into the sprite color locations (55287-55294). 



Sprite 


Default Colors 





White 


1 


Red 


2 


Cyan 


3 


Purple 


4 


Green 


5 


Blue 


6 


YeUow 


7 


Grey 2 
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MULTICOLOR SPRITES 

A mulitcolored sprite is a more advanced technique. In this mode, the 
computer reads your sprite data in a slightly different way, in bit pairs. 
Two bits are read as one piece of data. 



• o 




O O 




O • 


• • 


7 6 




5 4 




3 2 


1 


A 


B 


C 


D 



Bit pair 'A' tells the computer to get the color for the area from the 
sprite color register (from 55287-55294, depending on the sprite you're 
working on). 

B is screen color, so it will look like a blank space. 

C is the color value POKEd into location 5 3285 , multicolor register #0. 

D is the color in multicolor register #1, 53286. 

The program below switches a sprite from standard mode to multi- 
color mode. 

VARIATIONS ON ATHENE OF PROTO 

1 060 REM > > > > :> I N I T I AL I Z T I ON 

1070 REM >> CLEAR SCREEN/BLUE CURSOR << 

1030 RRINT CHR$(147) : POKE 214, 6 

1090 GO TO 1390 

1100 : 

1110 REM >> SUBROUTINES GO ON TOP 
1120 REM >> RESET SWITCH SUBROUTINE << 
1130 IF N=l THEN N=0 : RETURN 
1140 : N=l : RETURN 
1150 : 

1160 REM >> EXPAND SUBROUTINE << 

1170 REM >> CHECK FOR 'Fl" KEY FIRST << 
11S0 IF PEEK (197) <>4 THEN RETURN 
1190 POKE 53265,11 : REM BLANK SCREEN 
1200 POKE VIC+23,N : POKE VIC^29,N 
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1210 POKE 53265,27 : REM SCREEN ON 
1220 GOSUB 1130 :REM SWITCH 3UBR- 

1230 RETURN 
1240 : 

1250 REM >> 3 INGLE /MULT I -COLOR SUBR. << 
1260 REM >> CHECK FOR ^F2^ KEY FIRST << 
1270 IF PEEK (197) <>5 U-iEH RETURN 
1280 POKE 53265, 1 1 : REM BLANK SCREEN 
1 2 9 F K E ' / 1 C -i- 2 S . N : R E \1 h iZ . r-l . S F R 
1300 POKE 53265.27 : REri SCREEN ON 
1310 GOSUB 1130 :REM SWITCH SUBR„ 

1320 RETURN 
1330 

1340 REM >> HEADEI-<; INFO,. SUBROUT INE < 
1 Z 5 R E f -1 D 11 D , H R : F R I H J H D " hi R 
1360 RETUi-^N 
1370 :; 

1380 REN >> r-'RIN T 1ST LINE : < 

1 Z90 PR I N I CI -IRiji (17) CHF:^ ( 29 ) ; 
1400 GOSUB 1350 
1410 : 

1420 REN >> F'R :i:NT 2ND 1... I NE < <: 

1 4:::0 FOf^ I 1 T O 3 " PR 1 NT lT iR^^ ( 1 7 ) CNR^I^ ( 29 ) 
1440 NEXT I 
1450 GOSUB 1350 
1460 : 

14 70 REM >> LAST LINE TO GO GiT < 
1 4B0 FOR I 1 TO 3 :: PR I N T Ci IR$ ( I /■ ) CNR$ ( 29 ) ; 
14 90 NEXT I 

;l. 5 F R 1 1 ■]" 5 : P F< I \ \ J C W R % (29);;: N P. X 1 :[ 
1510 PR I NT "HIT ANY KEY TO CONTINUE" 
;l. 5 2 13 E T' A % : 1 1 ■ ■ A 4> " ' ' 1 H E N 1 5 2 
1'5Z0 Pf-Y[ N T CHR:ii ( 147) : N^^0 
1540 :; 

1 5 5 R E 1-1 > > S E T 3 P R I T' E G F\ 3 T A 1 4 T 3 < ■ 
1560 VIC ■■■■^ 53248 :: REr 1 BASE OF 910 Ci-NP 
1570 IBt... 13 :REM (TUNBER OF r.<i.JjGT:;S 

1530 MEN - 64^TBL:REN L.OG„ OF SPRITE;- 
1590 : 

1600 REM :>:> TUI-4T OFF- Si;j'VEE:N << 
1610 REN I'-'01<;E 53265, 1 I 
L:S20 : 
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J. 6 R E i > > S E. 1 ■ h A C ! :• „ m D B \ < D iE R C L (J R S 

1 6. 4 I ' (J R. E Z 2 3 , 1 : R C) 1 R. 5 Z 2. B 1 ,, 1 
i6'50 

:i 6 j- s I'j > > ^3 E r E> F' {^^ I T' e: d a y a r 1 im t" e r < < 

1670 RDRE 2040, TBR 

i 6 80 : 

1620 REh ::• > IIJRM ON SPRITE # << 

1700 POKE VICK21., 1 

1710 : 

1720 REH >> SET SPRITE 0' S PGSITIGIM << 

i •/ R (J R E V ;[ c , 1 s : R g r e 2 1 c ^ 1 , 1 2 

J 7 4^;;> :; 

E72.j^^) I'iEH SET ^i>PRITE (.JUEGRS : < 

[ / 6 1'j R G R. E. 2 1 c: 7 2 : r e r i - rc. m .. i-^ e (j . # .1. 

[77 PURE VIC-i-39, 4:; REM SPFEPrE 40 CGL.GR 



^ . ' 


1 s ».... 1 1 




GPTIGiM ru PXPAi-ID SPRITE 40 


} \...' 






IC-i~23„ N :;REN 


F XPANi") y 


' { 1 I'i 

1 ' ' " ' '''j 


i I..M -. l... 


9IC-i29,, N :REri 


-- ;:• i; - XF A)MD \^ 


i \ - ''^'^ 


^'t••l'l 

1 X 1... 1 J 




SEiJi-CT N.. C.N 


FOR SPITPIE 40 


1 I > '• r 

1 1: • ■.; 


-■■'("ii-'f"' 


VIC^2B, l-l 




i s .«!■■' 

1 360 


REii : 




READ SPRITE 


DATA WITH A 


1370 


REM ; 




( 1 1 i 1 ) 


BIT HASP 


1330 


FOR 


I 


^ ru 23 




1390 


READ 


P 


:: POKE (NEN^I ) 


P AND 170 


1 900 


NEXT 


1 






1920 


rer\ 




READ DATA VI/ 


(01010101 ) HASP 


1930 


PGR 




24 TG 55 




1940 


r^EAD 


p 


: PGKE (NENiJ) 


, P AND 3^ 


1950 


NEXT 


J 






1970 


REN 


7 y 


READ DATA W/ 


\ 10101010) HASP 


1 980 


PGR 


R 


56 TG 62 




1990 


READ 


P 


:; pgi<;e (nen-ho 


, P AND 170 


2000 


NEXT 


R 






20 1 










2020 


RER\ . 




i URN SC}-(EEN 


BACh; ON << 


2070 


RQRE 


v_J .1-. \„.' 




2040 










20'50 


RER : 




SET SWrrCN/NNITE CURSOR << 


2060 


N-1 


:PGPE 646. 




2070 
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2030 REM >> FLASH M-"'F<GTG ^' , TI-IEN WAIT << 

2 9 P R 1 N [• C W R $ ( :l 4 7 ) :RE hi C L E A R 3 C R E: E. M 

2 :j. F (J R 1 1 T 1 R R I IM T" [: hi R $ (17) C hi R % (29):; 

21;l0 NEXT I 

2120 RR1NT"RRGTD" FOR W^^n:TrG50« MEX I V\ 

2 1 Z0 PR I NTCHf^ ;l> ( 1 47 ) : FGf^ W-0TG5^;:) : NE X T W 

2140 :; 

21S0 REM :>> CHECK SUBRGUTINES << 

2 1 ^> 6 G S U B 1 1 B : R E 14 E. X R A IM D tii I- I T E. X Y 

2 1 / B S U B 1 2 7 : R E H S I M G L„ [i / 14 IJ L_ I ' I - C G I.... G R 

2180 GG TG 2090 

2190 ;: 

220^-i REN > > > > > HEADER I NFCJ DATA < < < < < 

2210 D A T A l-l 1 J F 1 ' T U E X R A N D G R 

2220 DATA UN EX RAND SRRITE 

22:m;:> i)ATA HIT ' EZ' TO SEE NULTl CGh.GR 

224^-> DATA SRRITE; 

2: 2 6 R E N > > > > > R R G I" ' S DA "I ' A < < < < < 

2270 DATA , 60 , 1 , 255 , 1 28 , 7 255 224 , 3 1 

22/5 D A r A 23 1. , 252 63 , 23 1 , 254 , I '5 , 255 , 24 S 

2 2 7 6 D A T A 7 , 255., 240, , 2 5 5 , 128, , 2 5 5 , 1 2 8 

2: 2 7 7 DA T A , 1 9 Z , 128, iliJ , :l. 9 Z 123, , 1 -i Z ^ I 2 3 

2278 DATA , 1 93 , 1 28 , , 193., 1 28 , ., 1 93 , 1 28 

2 2 / 9 D A I " A , 1 9 Z , 1 2 8 , , 1 9 Z 1 2 3 , , 1 ■ ? Z 1 2 3 

:.; ■ 2 B D A T A , 1 9 Z , 1 2 B 3 2 4- 7 ,224 Z , 5 4 S' 6 

The other parts of sprite programming such as priorities and collision 
detection are rather straight forward. Just refer to the necessary location 
for more details on their use. With priorities, just remember that they are 
set automatically with sprite having the highest priority. Sprite will 
pass in front of sprites 1 to 7 . Sprite 1 will pass behind #0 and in front of 2 
to 7 . Sprite #2 will pass behind #0 and # 1 and in front of 3 to 7. You can 
see the pattern. All sprites have priority over background data. If you 
want to change any particular sprite's priority with respect to the 
background and make the sprites pass behind the text, the proper bit in 
the sprite priority register must be set (see loc. 53275). 

Collision detection is no harder to use. The sprite collision registers 
are "read only" registers whose bits change to 1 whenever a collision has 
occurred (see Iocs. 53278 and 53279). It is easy to test for the coUision, 
but that test must be done strategically in your code such as in a main 
motion loop. Collisions can be determined by one line of code. 
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APPENDIX I 



FOR SPRITE-TO-SPRITE COLLISIONS USE: 
IF PEEK(V+30) AND X THEN [ACTION] 
FOR SPRTTE-TO-BACKGROUND COLLISIONS USE: 
IF PEEK(V-I-31) AND X THEN [ACTION] 
where 'X' is the decimal value of the bit in the collision register. 



SPRITE # 


BIT 


VALUE 








1 


1 


1 


2 


3 


2 


4 


3 


3 


8 


4 


4 


16 


5 


5 


32 


6 


6 


64 


7 


7 


128 



In a very brief outline form, here's how to create a sprite. Part I (A) is 
true for all programs you write, the remainder deals with only the sprites. 

Those marked with an * are optional depending on your level of ability 
and how you want the sprites to look. You can create and move sprites 
without them. 
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SPRITE ALGORITHM OUTLINE 



1. PROGRAM INITIALIZATION 

A) Declare Program Parameters 

1 . Dimension arrays 

a. integer 

b. string 

c. real 

2. Set constants and variables (same items as under arrays) 

B) Declare Sprite parameters 

1. Set constants and variables pertinant to sprites 

a. VIC=53248 => start address of the VIC-II 
*2. Turn off screen (POKE VIC-hl7,l 1) 

3. Store sprite data 

a. set data pointers (Iocs. 2040 - 2047) 

b. use FOR/NEXT loop to read in data 

4. Enable Sprites (VIC+21 ) 

5. Set sprite color registers 

a. single color sprites (POKE Iocs. 

VIC-h39 -h VIC+46) 

*b. multi-color sprites (POKE Iocs. 

VlC+37 -h VIC-h38) 
*6. Enable sprite color mode 

a. Turn bit four on in multi-color register (VIC-l-22) 
*7. Select expanded sprites (VIC+23 and VIC+29) 
*8. Tum screen back on (POKE VIC+17,27) 
2. MAIN PROGRAM LOOP 

A) Set sprite motion FOR/NEXT loop 

L PEEK at sprite positions (VIC + VIC+16) 

a. call them X and Y 

2. Determine how far you want to move 

a. call the amount of motion DX and DY 

3. Determining direction of motion 

*4. Monitor sprite collision registers (DX=— DX, 
DY=-DY) 

a. sprite-sprite collision 
^ b. sprite-data collision 

5. Check X positions of sprites whether to POKE MSB in 
VIC-hl6 

a. Check position border constraints (see sprite pos. Iocs. ) 

6. Add offsets to original position: X=X-I-DX, 
Y=Y-hDY 

7. Exit position update loop 
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B) Evaluate multiple sprite displays 

1. POKE VIC-fl6 with the value determined by the sprites 

whose X position is greater than 256. 

*2. Check raster register for special interrupt conditions 

a. mix-moded displays (character w/ bit-map mode) 

b. moving more than eight sprites 

c. light-pen 

3 . POKE updated position (X, Y) back into position registers 

4. Go back to II- A) if y 



^ Start ^ 



Initialise 
Program 



Initialize 
Spnte<s) 




Check Sprites 
X-Pos. > 255 



Check Raster 
Register for 
Interrupt 
Conditions 
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This last program contains a machine language routine to move sprites 
quickly across the screen. The speed range is from 1 to 5. Press 
RUN/STOP to end the program. 

1000 REM ****#*»*****■)«•***♦****♦»•«•***•«•** 
1010 REM * THEME ON A VARIATION OF * 
1020 REM * P R O T O * 

1030 REM * MOVING PROTO WITH JOYSTICK * 
1040 REM * ALGORYTHM BY SHELDON LEEMON* 
1050 REM ♦♦♦*»**********-#*******»##«-**«- 
1060 : 

1 070 PR I NTCHR* < 1 47 ) ; CHR* < 5 ) : SP=5324S 
1080 INPUT "SPEED (1-5) ";S:GOTO 1190 
1090 : 

1100 REM >>>>> SELECT SPEED <<<<< 
1110 ON S GOTO 1120,1130,1140,1150,1160 
1120 SYS (49409) : GOTO 1120 
1130 SYS (49406) : GOTO 1130 
1140 SYS (49403) : GOTO 1140 
1150 SYS (49400) :G0T0 1150 
1160 SYS (49413) : GOTO 1160 
1170 : 

1180 REM >>>>> STORE SPRITE DATA <<<<< 
1190 FORI=871T0S95:POKE 1,0: NEXT 
1200 F0RI=832T0a94:READ A: POKE I, A: NEXT 
1210 : 

1220 REM >>>::• > SET SPRITE PARAMETERS << 

1230 POKE SP+21,1 :P0KE 2040,13 

1240 POKE SP-t-39,6 : POKE SP+29, 1 

1250 POKE SP,160 :P0KE SP+ 1,100 

1260 POKE SP+32,0 : POKE SP+33,0 

1270 PRINT CHR*(147) 

1280 : 

1290 REM >>>>> PLACE STARS IN <<<<< 
1300 FORI=1TO50 

1310 : POKE 1024+INT (RND(0) *1000) , 46 
1320 NEXT 
1330 : 

1340 REM >>>>> PROTO 'S DATA <<<<< 
1350 DATA 0,60,0,1,255,128,7,255,224,31 
1360 DATA 231,252,63,231,254,15,255,248 
1370 DATA 7,255,240,0,255,128,0,255,128 
1330 DATA 0,193,128,0,193,128,0,193,128 
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1390 DATA 0,193,128,0,193,128,0,193.128 
1400 DATA 0,193,123,0,193,128,0,193,128 
1410 DATA 0,193,128,3,247,224,3,54,96 
1420 : 

1430 REM >>>>> STORE <<<<< 

1440 REM >>>>> MACHINE LANGUAGE <<<<< 

1450 REM >>>>> ROUTINE <<<<< 

1460 FORI=1TO101 

1470 : READ A: POKE 491 51 + 1, A 

1480 NEXT 

1490 : 

1500 F0RI=1T019 

1510 : READ A: POKE 49399+ 1, A 

1520 NEXT 

1530 : 

1540 REM >>>>> RETURN TO UPDATE <<<<< 
1550 REM >>>>> POSITION <<<<< 

1560 GO TO 1110 
1570 : 

1580 REM >>>>> MACHINE LANG. DATA <<<<< 
1590 DATA 173,1,220,74,176,3,206,1,208 
1600 DATA 74,176,3,238,1,208,74,176,38 
1610 DATA 173,0,208,208,15,173,16,208 
1620 DATA 41,1,240,12,173,16,208,41,254 
1630 DATA 141,16,208,206,0,208,96,173 
1640 DATA 16,208,9,1,162,63,141,16,208 
1650 DATA 142,0,208,96,74,176,32,238 
1660 DATA 0,208,240,28,173,16,208,41,1 
1670 DATA 240,20,169,64,205,0,208,208 
1680 DATA 13,173,16,208,41,254,162,0 
1690 DATA 141,16,208,142,0,208,96,173 
1700 DATA 16,208,9,1,141,16,208,96 
1710 DATA 32,0,192,32,0,192,32,0,192,32 
1720 DATA 0,192,96,32,0,192,76,5,193 
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COMPOSING MUSIC 



Rattle off a quick tune in your head. Now think for a moment all the 
variations of pitch, volumn and tonal qualities that go into just a few bars 
of it. If you pick up the manuscript of a fully scored symphony, you may 
find overwhelming amounts of description for all the sounds that each 
instrument is responsible for. Little wonder how much training a modem 
composer or conducter must have to to attain mastery over musical 
expression. 

With the advent of electronic synthesizers in the mid-1 970's, key- 
board musicians were introduced to new vista of musical performance 
with a wide range of dynamics, phrasing and articulation. The resulting 
explosion of creativity has lead to altogether new musical forms and 
ideas. And now in the 80's this has taken another step with the 
introduction of musical synthesis in home computers. 



SOUND PROGRAMMING TECHNIQUES 

The nice thing about programming sound on the Commodore 64 is that 
all its given features can be programmed in BASIC up to three voices. 
The 3 voices are just like having 3 musicians ready to make any sound 
you want The only difficulty involved in sound progranmiing consists of 
closely watching which values have been POKEd into the sound 
registers. 
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Needless to say, BE PATIENT. You will find after sound program- 
ming experimentation that even your mistakes may produce useful 
sound. 

Let's get to some basic techniques. For practical purposes, there are 
only two ways to provide the information you need to make sounds. You 
can generate the sounds by POKEing in numbers one at a time, or put 
this information in data statements to be read as the program runs. 

Before a sound can be made, be sure to do these things first 

1 ) Clear the SID chip to get rid of any unwanted values in the registers. 
A FOR/NEXT loop will do the job. 

100 REM SOUND CI -} 1 1 

110 910=^^54272 

12^;:) REM CLEAF-^ THE 

13^;:) FOR I - TO 23 

1 40 FuKE. 3 1 1) -' - 1 ^ 

1'50 NEXT 



2) Turn on the volume control on the chip. 

1 6 R E r I IE '.! it! E. Ei j, 1- 1 E 3 "\ ' V (J L.. U M E . 

170 FnKEBID-i-24, 15 

is the highest volume. 



3) Set the frequency you want Check the note table at the end for the 
values you need. 

180 REM SET f-IIGl-l BYTE AND EiM BYTE 

19 ^;:) REM TO RRODIJOE rilDDEE C IN VOICE 

200 REM ONE.. 
210 R0KESID,34 
220 ROKESlD+1 75 

These are the values for C in the 5th octave, middle C. 



H i hH I 1 NO HijlJR 



'n I...' .}. > >._, ) \ •...> 
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4) Set the Attack, Decay, Sustain and Release values. 

230 REM - SET THE ATTACK /DECAY RATEu 
240 P0KESID+-5, 16 

250 REM - SET THE SUSTAIN/RELEASE RATE. 
260 POKES ID -1-6., 249 

With those steps taken care of, you can now work with filtering, 
modulation and syncronization or just enter all the above lines and turn a 
specific waveform on. 

270 REM - CHOOSE THE SAlAlTGuTi-l WAVEFGRH 
280 REM AND TURN IT 0N„ 
290 POKESID+4, 33 

and off 

300 REM - START THE REEEASE CVCL.E 
310 POKES I D4 4, 32 




OUTLINE FOR SINGLE VOICE 

This short outline contains all the steps necessary to produce a sound 
with a single voice. Part I (A) is true for all programs. You write. 
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L PROGRAM INITIALIZATION 

A) Declare Program Parameters 

1 . Dimension arrays 

a. integer 

b. string 

c. real 

2. Set constants and variables for the other parts of your 
program. 

B) Declare Sound Parameters 

1 . Assign constants and variables pertinent to sound 

a. SID =54272, the start address of SID chip. See location 
54272 for an example of using this method. 

2. Clear the sound chip 

a. use FOR/NEXT to POKE zero into the SID chip 
registers (SID to SID+24) 

n. MAIN PROGRAM LOOP TO PLAY NOTES 

A) FOR/NEXT loop for voice production 

1 . Define functions for any one or all of the voice parameters 

a. Define frequency (SID -h voice frequency used) 

b. Define waveform (SID -f- voice control register) 

c. Define A/D/S/R (SID + A/D/S/R registers) 

d. Define filter (SID -f filter control register) 

e. Define filter (SID -f- filter control register bits 0-3) 

2. Define sound duration 

3. GATE ON voice control bit for specified duration 

4. GATE OFF voice control bit for specified duration (rest) 

B) FOR/NEXT loop for voice production stored in DATA state- 
ments 

1 . Store above voice parameters in DATA statements 

a. Store one or more parameters individually or, 

b. consolidate more than 1 parameter per given DATA 
element. 

2. READ voice information into voice parameter variables 

3. POKE voice information into respective voice parameter 
register 

m. DATA STATEMENTS OR NEXT PART OF PROGRAM 



MMM-K 
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^ Start ^ 



VOICE 



Initialize 
Program 



Initialize 
Voice(s) 
Parameters 



Set Pulse 
Width & 
FUters 



Set Ring 
Modulation 
& Harmonic 
Modulation 




Read Stored 
Music Data 



Decode: 
Dynamics 
Frequency 

Phrasing 
Articulation 






^/Change\^ 




^ Voice 




\^Parameters 




^!^No 




Morc^v 


Yes 


/ Than 1 \ 
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The programs below are samples of single voice programming. Play 
with these as much as possible, POKEing different values into the sound 
registers. Even your mistakes will lead you down new paths. 




[ O R E M ^ M- ik- M^ -ih-ik- -X- X -^it ^ -M- -M- 

1 1 R E M S (J 1. 1 M D t: X A M P L E: # 1 S C A L. E S 

J. 20 REiN * -x -^-^-^ -^^-M--^-^-^- )^ 

130 ; 

140 S 1 0=^=54272 s REM - - > START GF SOUND 

1 50 : 



160 REM >>>>> CLEAR SOUND CM IF <<<<< 
170 FOR S==SIDT0S1D+24:PGKE S,0:NEXT B 
180 : 

190 REM >>>>> SET VOICE VOLUME <<<<<■ 
200 POKE SID-»-24,7<?:REM > MAXIMUM 
210 : 

220 REM >>>>> SET A/D/S/R CYCLE <<<<<: 
230 POKE SID 5,vs REM SID + 6, 65 
240 : 

250 REM >>>>•• READ FREQ. DATA <<<<< 
260 READ HF, IF : REM HI FREQ.,LOW FREQ. 
270 : 

280 REM ^ > > > CHECK FOR END •■ :.: < < < 

2^?0 IF HF < O THEN POKE SID+-4,0: END 
300 s 

310 REht >>>>> POKE IN FREQ.. <<<<< 
320 POKE SID, I Ps POKE SID^-l, HF 
330 : 

340 REM >>>>:> GATE VOICE 1 W/ <<<<< 
350 REM >>>>> SAWTOOTH WAVEFORM ■::■■<<< 
360 POKE SID >- 4, 33 
370 : 

380 REM >>>> DELAY LOOP FOR <<<<< 
390 REM >>>>> NOTE DURATION <<••<<: 
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400 


FDR 


DUR - 1 


TO -^50- NEXT niJR 


4 1 








420 


REM 


■> ■> 


TURN OF VO I PF 1 ■: < 


430 


POKE 


SID 




440 








450 


REM 




GET NEXT N □ T E <" < < 


460 


GO T O 


230 




470 








480 


REM 




MUSIC DATA <<<<< 


490 


DATA 


34,75, 


38, 126,43,52,45, 198,51 


500 


DATA 


97,57, 


172,64, 188,68, 149 


5 1 


DATA 


76,252 


, 86 , 1 05 ,91, 1 40 , 1 02 , 1 94 


520 


DATA 


1 15,88 


, 129, 120, 137,43, -1 ,-1 



This example uses a high-pass filter and volume manipulation to 
produce the sound of an old water pump. 



i R b. M * -^^ * * H- -M- * • 

J. 10 REM ^ SOUND EXAMPLE #2 PUMP * 

120 REM -^f 

1 ZO : 

140 8TD=-^54272: REM START OF SOUND 

j 50 : 

160 REM :> >> > ■> CLEAR SOUND CHIP < < < < < 

170 FOR S=SIDT0S:[D4-24s POKE S,0:NExT S 

180 : 

190 REM ;> > :> > ■> SET VOICE VOLUME < < < < 

1 95 REM >>>>>?/ HIGH PASS F I ITER <<<<< 

200 POKE SID-^-24 ,79s REM -- > MAX. VOL. 

210 : 

220 REM > > :> > > SET A/D/S/R CYCLE < < < < < 

230 POKE SID ^- 5,148: POKE SID -i- 6, 26 

270 : 

310 REM >>:>>> POKE IN FREQ- <<<<< 

320 POKE SID, 240: POKE SID4-1, 33 

330 s 

340 REM >>>•>> GATE VOICE 1 W/ <<<<< 

350 REM >>>■>> NOISE WAVEFORM < < < 

360 POKE SID 4, 131 

370 : 

380 REM >>>>> DECREASE VOLUME < <<<< 

390 FOR VOL ==15 TO STEP -1 

400 POKE SID 24, VOL 

410 : 

420 REM :>>>>> SUSTAIN --'OL WITH <::<<< 

430 REM :>:>■>>> A DELAY LOOP <<<<< 
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440 FOR DUFv TG 25 s NEXT DUR 

450 : 

460 REh >V>;> NEXT VOLUNE SET 

470 NEXT VOL 

480 : 

490 REM >:>:>.> TURN OFF VOICE 1 

500 ROKE SID 4, 

510 : 

520 REM :>:- >>;^ RETURN 10 REFEAT 

530 GO TO 360 
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a 



o 




A low pass filter plus the interaction of voices 2 and 3 for the falling 
bomb effect - complete with explosion. 



1. ^.^0 




.1 1 


REM 


1 2i < 


REM 


] 30 


t. 


1 40 


8 T D^- 


150 




1. 60 


REM 


170 


EGR 


1. BO 




i 90 


REM 


200 


ROKE 


210 




220 


REM 


230 


ROKE 


240 
250 


REM 


260 
270 


RGKE 


280 


REM 


290 


REM 


300 


REM 


: •> 1 () 


RGKE 


320 




330 


REM 


340 


REM 


350 


RGKE 


360 




370 


REM 



UWD EXAMRLE 3 BGMh 

2: REM :^ START GE SOUND 
> Cf .EAR SOUND CHIR •• : . < < < 



>:> > ETLTER CUTGFE FREQ. 
'OKE S I D+2 1 , 1 2 RGKE 3 1 D + 22 , 1 1 

>>> SET VOICE 3 FILTER 



>>> SET VOICE 3 VOLUME <<< 

> > > W/ LOW-PASS FILTER < < < 

> >■> ?:< CUTOFF < ^;< 

RGKE Sn;)4-24, 15^ 



> GATE VOICE 3 WITH 

> TRIANGLE WAVEFORM 



SLIDE DOWN VOICE 
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380 


REM 


>>> > > FREQUENCY 


3v0 


FOR 


HF=:230TG20SrEP-- 1 


400 


FOR 


I P:::. 2 55100 RTEP ~100 


4 1 


POKE 


310 +1.4 J Fs POKE SID415,HF 


420 


N£ x T 


LF 


430 


IF I 


F<0 THEN NEXT HF 


440 






450 


REM 


:>>>.:• TURN OFF VOICE 3 : : < 


460 


POKE 


S 1 D"i- 1 8 , 1 <b : REM — > RELEASE 


470 






480 


REM 


>>>:>> PAUSE A MOMENT <<< 


490 


FOR 


DUR --^ .1 TO .100: NEXT DUR 


500 






5 1 


REM 


>>>>> SET UP VOICE 2 FOR < 


520 


REM 


>;>:>>> HARD SYNC. WITH 3 


530 


POKE 


SID4-8,5:REM > FREQ 


540 


POKE 


SIDh-12 , 15: REM > A/D/ 


550 


POKE 


S I D+ 13, 255: REM > S/R 


560 






570 


REM 


>>>>> GATE VOICES 2 3 < < 


580 


POKE 


S I D+ n , 131: F-'OKE S I D+ 1 8 , 


590 






600 


REM 


:•>:>>> SO KIND AN EXPLOSION <■ 




PPM 


• •• ^ V ».J .1. i_^L Ij'tr. ' ...-rVl. l -is..)!... ■• 


620 


REM 


>>>>> OF VOLUIME <: 


630 


FOR 


L-IOTOO SIEP --0.I 


6 4 


POKE 


SID i- 24, L 


650 


NEXT 


\. 


660 
6 7 


REM 


>• >>:■ TURN OFF VOICE 2 < 


680 


POKE 


S I D-t- 1 1 , : REM - -- PEL EhSF 


6^0 


END 
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20 
21 



26 
27 
28 
29 
30 
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An example of ring modulation 
using voices 1 and 3 produces 
this sound. 



REM -M- -M- -M- -A ★ -^^ 

REM * SOUND EXAMF'LE 4 BUSY SIGNAL^- 

F< E M ^ * * fir -fh fir Hr ^ H- •)< fh M "i^ * -M- -M" -ff * 




:D:^:=542 



's REM 



BTART GE SOUND 



3:4 


j 


REM 




") 


REM 


36 


J 


REM 


"5 7 


■) 


POK 


38 


"J 




39 


'} 


REM 


40 


') 


EOR 


41 


j 




42 





REM 


43 





PGK 


44 






45 


") 


REM 


46 


') 


GO 



REM >>:; ■•> CLEAR SOUND CHIP 

EOR S^SIDTOSI D + 24S POKE 8,0:; NEXT 

REM V>>>> SET EREQ. VOICE 1 < < < = 
POKE SID+I , 7^ 

F< E M ■■■ . • > :> > V ' O 1 1; E- 1 A / D / S / R < < ■■' < 

POKE 3 I D ^ T^. , 2 : PO K E SI D 6 , O 

REM ■>:■•>>> SET EREO. VOICE 3 <<<< 
POKE SID-M!^^. , 3c> 

REM > > > > SE T VOLUME < < < •^ 

POKE SID + 24, 15s REhl ~--> MAXIMUM 

REM >>>>> SET DELAY LOOP <:.<■ << 
EOR DUR=- 1 ro 1 00 : NEXT DUR 

>>>> GATE VOICE 1 W/ < < < < 
>:>>> TRIANGLE NAVEEORM <<<< 
>:>:>> Z< RING MODULATION < < < =: 



ANOTHER DELAY LOOP 



RETURN TO REPEAT 
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Two voices, one siren with hard syncronization. 



I, ( ■ ' O R E hi * * * * * 'x * * ^ -i^- * ^ * * A 
J 10 REM SOUND EXAhPI. E SIREN 

1 2 R E. M * * -M- * -H- -M- * M- i< * * ^- M- -^t- * -X- * -fr -M- 

1 30 ; 

140 SID=^542/2: REM > START GE SOUND 

150 : 

160 REM >>■>>> CLEAR SOUND CHIP <<<<< 

1 70 EOR S=S I DTDS I D+24 5 POKE S , s NE X T S 

180 : 

190 REM >>:>>> VOICE 1 A/D/S/R - • : < < 

200 POKE 3ID+-5,100: POKE SID-+-6,100 

210 : 

220 REM >>>>> SET VOLUME <: < < < 

230 POKE S I D + 24 ,15: REM - > MAX I MUM 

240 : 

250 REM >>>>> SET EREQ, VOICE 3 < < < 

260 POKE SID+15,30 

270 s 

280 REM >>>>> GATE VOICE 1 W/ <<< << 

290 REM >>:>>> TRIANGLE WAVEEORM <<<< 

300 REM >>>;>> ^/ HARD SYNC. • <<<< 

310 POKE SID+4, 19 

320 : 

330 REM >:>>>> INCREASE VOICES 1 < < < < 

340 REM >>>:>> 3 EREQUENCIES <<<<. 

350 EOR HE 30 TO 40 

360 EOR LE ^- O TO 255 STEP 20 

370 s 

380 POKE SID+1, HE: POKE SID, LF 

390 POKE SIDfl5,HE: POKE SID+14,LF 

400 : 
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41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51, 

53 
54 
55 
56 
5 '7 
5B 
59 
60 



NEXT LF\HF- 

;:• REM :•:■>:■:> SET DELAY LOOP < < < 

) FOR DUR-1 TG2503 NEXT DUR 

) : 

> REM >>■>> DECREASE VOICES 1. < ^ 
) REM >>:>> 3 FREQUENCIES <<^ 

> EGR HE 40 TO 30 STER-1 

> EOR LE 255 TO STEP -20 

) RDEE S I D ^ 1 , HE : POKE SID, LF 

) POKE S I Dh- 15, HE: POKE SID+j4J..,F 

) : 

) NEXT LE,HE 

) : 

) REM >>>>> SET DELAY LOOP 

) EGR DlJR^^-rrG250s NEXT DUR 

) : 

> REM >:.:■>>> RETURN TO REPEAT = 
) 80 TO 350 
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The 'drip' uses a pulse waveform and ring modulation. 
100 REM 

110 REM ♦ SOUND EXAMPLE 6 DRIPPING * 
120 REM ***************************** 
130 : 

140 SI 0=54272: REM — > START OF SOUND 
150 : 

160 REM >>>>> SET FOR /NEXT STEP <<<<< 
170 SP = 0. 1 
180 : 

190 REM >>>>> CLEAR SOUND CHIP <<<<< 
200 FOR S=SIDT0SID+24:P0KE S,0:NEXT S 
210 : 

220 REM >>>>> SET VARIABLE DELAY <<<< 
230 FOR DUR=1TO1000 STEP SP+0. 1 
240 : 

250 REM >>>>> SET VOICE 1 FREQ. <<<<< 
260 POKE SID+1, RND<1)*200+1 
270 : 

280 REM >>>>> VOICE 1 A/D/S/R <<<<< 
290 POKE SID+5,10: POKE SID+6,255 
300 : 

310 REM >>>>> SET VOICE 3 FREQ. <<<<< 
320 POKE SID+1 5, RND(l) #200+1 
330 : 

340 REM >>>>> SET VOLUME <<<<< 
350 POKE SID+24, 15:REM — > MAXIMUM 
360 : 

370 REM >>>>> GATE VOICE 1 W/ <<<<< 
380 REM >>>>> SQUARE WAVEFORM <<<<< 
390 REM »>>> S< RING MOD. <<<<< 
400 POKE SID+4, 69 
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410 : 

420 REM >>>>> SET VARIABLE DELAY <<<< 
430 FOR T=1TO1000/DUR: NEXT T 
440 : 

450 REM >>>>> SATE VOICE 1 W/ <<<<< 
460 REM >>>>> TRIANGLE WAVEFORM <<<<< 
470 REM >>>>> Z< RING MOD. <<<<< 
480 POKE SID+4, 21 
490 : 

500 REM >>>>> INCREMENT STEP VALUE << 
510 SP = SP + 0.9 
520 : 

530 REM >>>>> NEXT DURATION <<<<< 
540 NEXT DUR 
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If you put 
this airplane 

example with the bomb you're halfway to some game sound effects. 

I ' ' F'.- E )i « ^- •« * -H- -M- ft- ^- ^- -M- -M- -^1- M- -M- * -^^ 



1 J 


RFh 


* SOMh^ln Ex v^LIPLE 7 PI. mML 


1 2r) 


REM 


-^f K ^ -Hh >t- -M- -M- ^- i^- M- A- ^ -> M- M * 


1 3(j 






140 




54272!! REM --> START OF SOUND 


150 


- 




1 60 


REM 


>>■:■>> CLEAR SOUND CHIP <<<<< 


1 70 


FDR 


S==S I D rOS I D-H24 : POKE S , : NE X T 


1 80 






1 90 


REM 


> > > > > V 1 CE 1 A ./ D / S / R < < < < < 


200 


POKE 
- 


SID+5,20: POKE SlD+-6,20 


210 

220 


REM 


>>>>> SET VOLUME <<< << 


230 


POKE 


S I D4-24 ,15:: REM - - > MAX I MUM 


240 






250 


REM 


>>>>> SET CONSTANT FREQ. <<< 


260 


LF 


255: HF =^ 7 


270 






280 


REM 


>>>>> GATE VOICE 1 W/ <<<<<: 


290 


REM 


:>>>>:> SQUARE WAVEFORM <<<<< 


300 


POKE 


SID-f4, 65 


3 1 






320 


REM 


> > > > > I NCREASE PULSE < < < < < 


330 


REM 


>>>>> WIDTH MODULATION <<<<< 


340 


FOR 


PH = TO 15 


350 


FOR 


PL ^ TO 255 STEP :l 


360 


POKE 


5IDL2, PL: POKE STDf3, PH 


370 






380 


REM 


>>: >> SET VOICE 1 FREQ. <<<< 


390 


POLE 


SID, LF:POKE STD+1 , HF 


400 






4 1 


REM 


•> > > > > D E C REAS E F R E Q « < < < < < 


420 


LF 


LF -- 5 


43<'::' 


TP L 


F<0 TLIEN LF=^255: HF - HF-1 


440 






450 


NEXT 


PL , PH 
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MULTIPLE VOICE PRCXSRAMMING 



Consider for a moment what might be involved in programming more 
that one voice. Here again, plan well or you may run into complications. 
In setting up a multi- voice program, you should introduce more variables 
and arrays for easy storage and computation os each separate element of 
voice information. 

This presents a problem if you are getting all your information from 
data statements. Think of how long your data statements might be if you 
had to store the frequency, waveform, A/D/S/R cycle, duration, or any 
other involved voice information sepaprately for each voice! If nothing 
else, it would take forever for it to be READ into arrays. 

For long sound program, this time to load your voice information 
cannot be avoided. However, there are several ingenious methods for 
using a given data element for describing more that one voice parameter. 
This cuts down on DATA elements, hence the time it takes to read them 
in. Here is just one such method provided in Commodore's "Pro- 
grammer's Reference Guide". It lets you write a multi- voice program by 
creating proper DATA tables for all your sound information. These are 
the steps: 

1 ) Take each note's duration (the number of 1 / 1 6 ths which it constitutes) 
and multiply it by 8. 

2) Add the result of step 1 to the octave (0-7) from the note table. 

3) Take this result and multiply it by 16 

4) Take this result and add your note to it from the note table 
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Another way of saying this is to have D, O and N represent duration, 
octave and note respectively. The result of this little formula is one 
DATA element for one voice's information: 

Data Element - (((D*8)-hO)*16)-hN) 

Now all that your code has to do is disassemble this information to be 
POKEd into the correct registers. 

The next thing to consider is to coordinate the two or three voices 
together. In other words we must determine the durations and rests of 
multi-voices at one time. 

1) Divide each musical measure into 16 parts. 

2) Store the events that occur in each 1/1 6th measure interval in three 
separate arrays. 

3) Process array information using the waveform control byte as a 
starting signal for beginning a note or continuing a note that is already 
playing. 
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The multi-voice outline is more complex than the single voice, but it 
really does more. 



OUTLINE FOR MULTI-VOICE 

I. PROGRAM INITIALIZION 

A Declare program parameters (same as the single voice outline) 
B. Declare multi-voice parameters 

1 . Dimension arrays to contain activity of music 

a. 16th measure per location 

2. Dimension array to contain the base frequency for each note 

n. MAIN PROGRAM LOOP FOR MULTI- VOICES 

A. FOR/NEXT loops for storing into 3 -voice information arrays 

1 . frequency start address array 

2. waveform control byte array 
a. one element/voice 

Set parameters inherent of all three voices 

1 . Set voice registers that do not change in rest of program 

a. filter values 

b. pulse-width values 

c. etc. 

2. Special modulations 

a. ring modulation or hard sync. 

b. harmonic modulation (see S-l-28) 

c. any other additive modulations 
Nested FOR/NEXT loops for actual music execution 

1 . Set pointer to 3-voice activity array 

2. Begin decode loop for each voice's parameter, 
a. assign variables to each decoded parameter. 

3. POKE in respective values into respective voice control 
register 

4. Increment 3-voice activity pointer 

5. Go to II.C-1 to process next measure 

III. DATA STATEMENTS 
A. Set up DATA tables 

1 . Put starting frequencies per voice in one table 

2. Put encoded voice information in another table 

3. Use an element(s) to delimit end of program 

rV. GO ON TO NEXT PART OF PROGRAM OR END 



MMiM-L 
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If you can think of any brilliant alternative algorythms for multi- 
voices, you may have poineered a whole new approach, so please tell the 
world About the only limitation using multi- voices is that you don't have 
the diversity of special modulation you have with one voice because all 
voices are dedicated to their assigned waveforms and are not free to be 
added to others to produce some desired blends. However, you probably 
won't find this to be a problem for programming sound ideas. 

This sample program from Commodore's Programmers Reference 
Guide is a fine example of a multi-voice song. After you type 'RUN', the 
program will take 30 seconds to set up the data arrays necessary for the 
voices. 

1 S=54272 : F0RL=ST0S+24 : POKEL , : NEXT 
20 D I riH ( 2 , 200 ) , L ( 2 , 200 ) , C ( 2 , 200 ) 
30 DIMFQdl ) 

40 V ( ) = 1 7 : V ( 1. ) =65 : V ( 2 ) =33 

50 P0KEB^"10,8:PaKES4-22, 1 28 : PGKES+23 , 244 

60 FGRI=OTOn : READFQ ( I) :NEXT 

100 F0RK=0T02 

.1 1 I =0 

120 READNM 

1 30 I FNM=0THEN250 

1 40 WA= V ( K ) : I FNM< OTHENNM=~NM : WA= 1 

150 DR7.=NM/ 128: □□"/.= (NM-128*DR7.) 7 16 

160 NT=NM-128*DR7--16*0Cy. 

170 FR=FQ(NT) 

180 IF0C7.=7THEN200 

190 F0RJ=6T0DC7.STEP~1 : FR=FR/2:NEXT 
200 HF7.=FR/256: LF7.==FR-256*HF7 

210 I FDR7.= 1 THENH ( K , I ) =HF7- : L ( K , I ) =LF7, : C ( K , I ) 

=WA: 1=1+1 : GOTO 120 
220 F0RJ = 1T0DR7.-1:H(K, I)=HF7.:L(K, I)=LF7.:C 

(K, I)=WA: I=I+1:NEXT 
230 H ( K , I ) =HF7. : L ( K , I ) =LF7. : C ( K , I ) =WA- 1 
240 1=1+1 : GOTO 120 
250 IFI :>iriTHENIM=I 
260 NEXT 

500 POKEB+5 , 0: POKES+6 , 240 
5 1 POKES+ 1 2 , 85 : PGKES+ 13,1 33 
520 POKES+19, 10:P0KES+20, 197 
530 POKEB+24,31 
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540 FORI=OTOIM 

550 POKES , L ( , I ) : POKES-h? , L (1 , I) s P0KEB4- 1 4 , 
L (2 , I ) 

560 PGKES+ 1 , H ( O , I ) : POKES+8 , H (1 , I) : 

PDKES+1.5,H(2, I) 
570 P0KES4-4 , C ( , I ) : P0KES4- 1 1 , C ( 1 , I ) : 

P0KES4-ie,C(2,I) 
580 F0RT=1T080: NEXT: NEXT 
590 F0RT=1T0200: NEXT: POKES+24,0 
600 DATA34334 , 36376 , 38539 , 40830 
6 1 O DATA43258 , 45830 , 48556 , 5 1 443 
620 DAT A54502 , 57743 , 6 1 1 76 , 648 1 4 



1 (JOO 


DATA594 , 594 , 594 , 596 , 596 






1 1 


DATA 1 6 1 8 , 587 , 592 , 587 , 585 


,331 


, 336 


1020 


DATA 1 097 , 583 , 585 , 585 , 585 


,587 


,587 


1030 


DATA 1 609 , 585 , 33 1 , 337 , 594 


,594 


,593 


1 (:)4<:) 


DATA 1618, 594 ,596,594,592 


,587 




1050 


DATA 1616, 587 , 585 , 33 1 , 336 


,841 


,327 


1060 


DATA 1607 






1999 


DATAO 






2000 


DATA583 , 585 , 583 , 583 , 327 , 


329 




201 


DATA 161 1 ,583,585,578,578 


,578 




2020 


DATA196, 198,583,326,578 






2030 


DATA326 , 327 , 329 , 327 , 329 , 


326, 


578,583 


2040 


DATA 1 606 , 582 , 322 , 324 , 582 


, 587 




2050 


DATA329 , 327 , 1 606 , 583 






2060 


DATA327 , 329 , 587 , 33 1 , 329 






2070 


DATA329 , 328 , 1 609 578 , 834 






2080 


DATA324 , 322 , 327 , 585 , 1 602 






2999 


DATAO 






30^)0 


DATA567 , 566 , 567 , 304 , 306 , 


308 , 


310 


3010 


DATA 1591, 567 ,311,3 1 , 567 






3020 


DATA306 , 304 , 299 , 308 






3030 


DATA304 ,171,176, 306 , 29 1 , 


551 , 


306 , 308 


3040 


DAT A3 1 , 308 , 3 1 , 306 , 295 , 


297 , 


299,304 


3050 


DATA 1 586 , 562 , 567 , 3 10,315 


,311 




3060 


DATA308,313,297 






3070 


DATA 1 586 , 567 , 560 ,311, 309 






3080 


DATA308 , 309 , 306 , 308 






3090 


DATA 1 577 , 299 , 295 , 306 , 3 1 


,311 


,304 


3 1 00 


DATA562,546, 1575 






3999 


DATAO 
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ADVANCED SOUND PROGRAMMING TECHNIQUES 



Advanced techniques center on the use of modulation, filtering and 
variations of the A/D/S/R envelope. Here are some sample programs 
using these special features. The rest is up to your ability to POKE 
different values in to appropriate locations to hear the differences. Have 
a fun time programming sound! 

Sound in the commodore 64 lives in the MOS 6581 chip called SID. 
SID stands for Sound Interface Device and is a single-chip 3-voice full 
electronic music synthesizer/ sound effects generator. This chip provides 
all pitches, tonal qualities and dynamics that you can dream of in a 
computer. Specialized control circuitry has reduced the overhead in 
software required to produce wide sound variations. Here is a brief 
description of SID's chip specifications and pin configuration: 

3 TONE OSCILLATORS 
Range: 04 kHz 

4 WAVEFORMS PER OSCILLATOR 
Triangle, Sawtooth, Van able Pulse, Noise 

3 AMPLITUDE MODULATORS 
Range: 48 dB 

3 ENVELOPE GENERATORS 
Exponential response 
Attack Rate: 2mS-8S 
Decay Rate: 6mS-24S 
Sustain Level: 0-peck volume 
Release Rate: 6mS-24S 

OSCILLATOR SYNCHRONIZATION 

RING MODULATION 

PROGRAMMABLE FILTER 
Cutoff range: 30 Hz- 12 kHz 
12 dB/octave Rolloff 
Low pass. Band pass. 
High pass. Notch outputs 
Variable Resonance 



MASTER VOLUME CONTROL 
2A/D POT INTERFACES 
RANDOM NUMBER/MODULATION GENERATOR 
EXTERNAL AUDIO INPUT 



PIN CONFIGURATION 
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MUSIC NOTE VALUES 



MUSICAL NOTE 


OSCILLATOR FREQ 


NOTE 


OCTAVE 


DECIMAL 


HI 


LOW 





C-0 


268 


1 


12 


1 


C#-0 


284 




28 


2 


D-0 


301 


1 


45 


3 


D#-0 


318 


1 


62 


4 


E-0 


337 


1 


81 


5 


F-0 


358 


1 


102 


6 


F#-0 


379 


1 


123 


7 


G-0 


401 


1 


145 


8 


G#-0 


425 


1 


169 


9 


A-0 


451 


1 


195 


10 


A#-0 


477 


1 


221 


1 1 


B-0 


506 


1 


250 


16 


C-1 


536 


2 


24 


17 


C#-l 


568 


2 


56 


18 


D-1 


602 


2 


90 


19 


D#-l 


637 


2 


125 


20 


E-1 


675 


2 


163 


21 


F-1 


716 


2 


204 


22 


F#-l 


758 


2 


246 


23 


G-1 


803 


3 


35 


24 


G#-l 


851 


3 


83 


25 


A-1 


902 


3 


134 


26 


A#-l 


955 


3 


187 


27 


1 


1012 


3 


244 


32 


C-2 


1072 


4 


48 


33 


C#-2 


1 136 


4 


112 


34 


D-2 


1204 


4 


180 


35 


D#-2 


1275 


4 


251 


36 


E-2 


1351 


5 


71 


37 


F-2 


1432 


5 


152 


38 


F#-2 


1517 


5 


237 


39 


G-2 


1607 


6 


71 


40 


G#-2 


1703 


6 


167 


41 


A-2 


1804 


7 


12 


42 


A#-2 


191 1 


7 


119 


43 


B-2 


2025 


7 


233 


48 


C-3 


2145 


8 


97 



MUSICAL NOTE 


OSCILLATOR FREQ 


NOTE 


OCTAVE 


DECIMAL 


HI 


LOW 


49 


C#-3 


2273 


8 


225 


50 


D-3 


2408 


9 


104 


51 


D#-3 


2551 


9 


247 


52 


E-3 


2703 


10 


143 


53 


F-3 


2864 


1 1 


48 


54 


F#-3 


3034 


1 1 


218 


55 


G-3 


3215 


12 


143 


56 


G#-3 


3406 


13 


78 


57 


A-3 


3608 


14 


24 


58 


A#-3 


3823 


14 


239 


59 


B-3 


4050 


15 


210 


64 


C-4 


4291 


16 


195 


65 


C#-4 


4547 


17 


195 


66 


D-4 


4817 


18 


209 


67 


D#-4 


5103 


19 


239 


68 


E-4 


5407 


21 


31 


69 


F-4 


5728 


22 


96 


70 


F#-4 


6069 


23 


181 


71 


G-4 


6430 


25 


30 


72 


G#-4 


681 2 


26 


156 


73 


A-4 


721 7 


28 


49 


74 


A#-4 


7647 


29 


223 


75 


B-4 


8101 


31 


165 


80 


C-5 


8583 


33 


135 


81 


C#-5 


9094 


35 


134 


82 


D-5 


9634 


37 


162 


83 


D#-5 


10207 


39 


223 


84 


E-5 


10814 


42 


62 


85 


F-5 


1 1457 


44 


193 


86 


F#-5 


12139 


47 


107 


87 


G-5 


12860 


50 


60 


88 


G#-5 


13625 


53 


57 


89 


A-5 


14435 


56 


99 


90 


A#-5 


15294 


59 


190 


91 


B-5 


16203 


63 


75 


96 


C-6 


17167 


67 


15 


97 


C#-6 


18188 


71 


12 


98 


D-6 


19269 


75 


69 


99 


D#-6 


20415 


79 


191 


100 


E-6 


21629 


84 


125 
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MUSICAL NOTE 


OSCILLATOR FREQ 


NOTE 


OCTAVE 


DECIMAL 


HI 


LOW 


101 


F-6 


22915 


89 


131 


102 


F#-6 


24278 


94 


214 


103 


G-6 


25721 


100 


121 


104 


G#-6 


27251 


106 


1 15 


105 


A-6 


28871 


112 


199 


106 


A#-6 


30588 


119 


124 


107 


B-6 


32407 


126 


151 


112 


C-7 


34334 


134 


30 


1 13 


C#-7 


36376 


142 


24 


114 


D-7 


38539 


150 


139 


115 


D#-7 


40830 


159 


126 


116 


E-7 


43258 


168 


250 


117 


F-7 


45830 


179 


6 


1 18 


F#-7 


48556 


189 


172 


119 


G-7 


51443 


200 


243 


120 


G#-7 


54502 


212 


230 


121 


A-7 


57743 


225 


143 


122 


A#-7 


61 176 


238 


248 


123 


B-7 


64814 


253 


46 
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INDEX TO MEMORY LOCATIONS 



Because of the unique way that this book presents its information, we hav e 
grouped the memor\' locations by major topic, and then alphabetized 
them within the groupings. Names are given to locations as the\ are 
commonly called by either Commodore or a consensus of the literature. 
Many locations have not been named. Also, many locations do not have a 
simple common use that thcv' could be listed herebv'. If you don't see w hat 
you are looking for under a topic such as "Input Output", then look at the 
locations without descriptions. You may, of course, "fill in the blanks" as 
you discover uses for locations. 





MEMORY 




DESCRIPTION 


LOCATION 


NAME 


Basic ROM routines 


I ages 






1 1 7-1 25 




BASIC VARIABLES 






Address of current data item 


16 


SUBFI G 


BASIC mode flag 


65-66 


DATT^TR 


BASIC program storage area 


157 


MSGFI (i 


Character dispatch 


2048-40959 




Current BASIC line number 


776-777 


IGONE 


Current BASIC variable data 


57-58 


CliRI IN 


Current BASIC variable name 


71-72 


VARIANT 


Current byte of BASIC text 


122-123 


T X T P ER 


Current DA T A line number 


63-64 


O A I FIX 


Frror Message 


/68- /69 


I F K K C J K 


Index variable for FOR NEX 1 loops 


73-74 


FORPNI 


Input prompt flag 


19 




f^revious BASIC line number 


59-60 


OFDFIN 


Temporary data area 


255 


BASZT^l 


Temporary pointer data area 


75-96 




lext TJS T 


774-775 


IQPI OP 


Token evaluation 


778-779 


lEVAF 


Tokeni/e text 


772-773 


ICRNCH 


Warm start 


770-771 


IMAIN 




17 


INPFTX] 




34-37 


INT^EX 




61-62 


OT DTXE 




67-68 


INPT^TR 


Bytes and Bits 


Pages 10-14 




clock 


160-162 
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DESCRIPTION 



MEMORY 

LOCATION NAME 



COMPLEX INTERFACE 
ADAPTER (CIA) 

General Description 

CIA 1 

Control register 

Control register timer A 56334 

Data direction register port A 56322 

Data direction register port B 56323 

I/O 56332 

Interrupt control 56333 

Joystick 1 fire button/lightpen trigger 56321 

Joystick 2 direction 56320 

Joystick 2 fire button 56320 

Read keyboard row values 56321 

Time-of-day clock: hours 56331 

Time-of-day clock: minutes 56330 

Time-of-day clock: seconds 56329 

Time-of-day clock: 1/ 10 seconds 56328 

Timer A high-byte 56325 

Timer A low-byte 56324 

Timer B high-byte 56327 

Timer B low-byte 56326 

Write keyboard column values 56320 
CIA 2 

Control register A 56590 

Control register B 56591 

Data direction register Port B 56576 

Data direction register Port B 56579 
Data port A: 

serial IEEE/ RS-232 output 56576 

Data port B: RS-232 56577 

Future 10 expansion 56832-57087 

Future I/O expansion 57088-57343 

I/O 56588 

Time-of-day clock: hours 56587 

Time-of-day clock: minutes 56586 

Time-of-day clock: seconds 56585 

Time-of-day clock: 1 10 seconds 56584 

Timer A high-byte 56581 

Timer A low-byte 56580 

Timer B high-byte 56583 

Timer B low-byte 56582 



Pages 128-12< 
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DESCRIPTION 



MEMORY 
LOCATION 



NAME 



CI RSOR 

Character under cursor in ASCII 
Countdown to toggle cursor 
Cursor blink Hag 
Cursor blink toggle 

Glossary 

INPLT/OLTPLT 

Buffer start pointer 

Byte received flag 

Character parity 

Current de\ice number 

Current file name 

Current secondary address 

Default input device 

Default input device 

1 O buffer pointer 

1 O start address 

Input error log 

Length of current file name 

Load save memor\' pointers 

Load verify flag 

Logical file number 

Number of open files 

F^ass 1 error log 

Pass 2 error log 

Read write block count 

Serial word buffer 

Sync, countdown 

Sync, number 

Tape I O buffer 

Tape motor interlock 

Temporary data area 

Temporary DIIRQ indicator for 

cassette read 
Temporary storage for cassette read 
Timing constants 
TOD sense during cassette I O 



206 
205 
207 
204 

Pages 3-5 



178-179 
156 
155 
186 

187-188 

185 

153 

154 

166 

193-194 
256-318 
183 

174-175 

147 

184 

152 

158 

159 

190 

191 

165 

150 

828-1029 

192 

151 

676 

176-177 

674 



148 
149 

172-173 

180 

181 



GDBLN 
BLNCT 
BLNON 
BLNSW 



TAPEl 
DSPW 
PRTY 
FA 

FNADR 
SA 

DFLTN 

DFLTO 

BUFPNT 

STAL 

BAD 

FNLEN 

EAL 

VERCK 

LA 

I DTND 

PTRl 

PTR2 

FSBLK 

MYCH 

CNTDN 

SYNC 

CASl 



CMPO 

D65I0 

C3PO 

BSOUR 

SAL 

BITTS 

NXTBIT 
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DESCRIPTION 



MEMORY 
LOCATION 



NAME 



182 RODATA 
195-196 MEMUSS 





200 


INDX 




645 


TIMOUT 


INTERNAL REGISTERS 






Storage for 6502 .SP register 


783 


STREG 


Storage for 6502 .X register 


781 


SXREG 


Storage for 6502 .Y register 


782 


SYREG 


Storage for 6502 .A register 


780 


SAREG 


KEKIN AL 






Active logical file numbers 


601-610 


LAT 


BRT instruction interrupt 


790-791 


CBINV 


CHKIN routine vector 


798-799 


ICHKIN 


CHKOUT routine vector 


800-801 


ICKOUT 


CHRIN routine vector 


804-805 


IBASIN 


CHROOU T routine vector 


806-807 


IBSOUT 


CI. ALL. routine vector 


812-813 


ICLALL 


CLOSE routine vector 


796-797 


ICLOSE 


CLRCHN routine vector 


802-803 


ICLRCH 


Dev ice number for each file 


611-620 


FAT 


(jL I IN routine vector 


810-811 


IGETIN 


Kernal routines 


Pages 113-1 16 




LOAO routme vector 


Si I A k 1 7 
o 1 0-0 1 / 




\(^n-rTiHskahlp intpmint 


792-793 


NMINV 


C)PF\ rnntint^ vt^rtor 


794-795 


lOPEN 


SAVF routint^ vector 


818-819 


ISAVE 


Second address each tile 


621-630 


SAT 


STOP routine vector 


808-809 


ISTOP 


I tSUAKU 






Current key 


197 


LSTX 


INPUT GET from keyboard 


208 


CRSW 


Keyboard decode table 


243-244 


KEYTAB 


Keyboard shift key flag 


653 


SHFLAG 


Keyboard table setup vector 


655-656 


KEYLOG 


Last keyboard shift pattern 


654 


LSTSHF 


Number of characters in 






keyboard buffer 


198 


NDX 


Repeat delay counter 


652 


DELAY 


Repeat speed counter 


651 


KOUNT 


REPEAT key flag 


650 


RPTFLG 


Shift key flag 


657 


MODE 
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DKSC RIPTION 



MEMORY 
LOCATION 



NAME 



Si/c ot kcxboard biiltcr 
S I OP RVS kc\ Hag 

MATH 

[ loaliim RNl) 1 unction seed value 



\1 M R Y M A N \ (. I : M K \ I 

Bottom ol niLMnor) tor 

operating system 
Bottom ot siring storage 
laid ot BASIC arravs ( + 1 ) 
Highest address used b\ BASK" 
Load save memor\ pointers 
Start ot BASIC^ arra\s 
Start ot BASIC^ text 
Start ot BASIC^ variables 
l op ot memor\ tor operating svstem 
Utilits string pointer 

MIS( KLLANEOI S 



l emporarN data area 
I ' n used 
I ' n used 



649 
145 

139-143 

3-4 

5-6 

13 

14 

IS 

20-21 
38-42 
97 

98-101 

102 

103 

104 

105 

106-109 
1 10 
1 1 I 
1 12 

I 13-1 14 
256-266 



641-642 

51-52 

49-50 

55-56 

174-175 

47-48 

43-44 

45-46 

643-644 

53-54 

15 
146 

163-164 

679-767 
787 



XMAX 
SIKFY 

RM)X 
ADRAYI 
Al)RAY2 
VAl lYP 
IM HI Cj 
lANSCiN 
1 INNDM 
RFSHO 
FACtXP 
KAC HO 
1 AC SCjN 
S(iM (j 
BUS 

ARCifXP 

ARCiHO 

ARCiSCiN 

ARIS(iN 

FACOV 

I BIT P I 



SIRMEM 

FRF rop 

S I RFNI) 
MFMSiZ 
[ AI 

ARY lAB 
I X l l AB 
VAR I AB 
MFMSIZ 
FRFSPC^ 

(jARBFF 
SVXI 
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DESCRIPTION 



MEMORY 
LOCATION 



NAME 



Unused 
Unused 

Peek and Poke 

Reconfiguring the memory map 
RS-232 

Enables 

Index lo end of input buffer 

Index to end of output buffer 

Input bit count 

Input bits 

Input byte buffer 

Input parity 

Next bit to send 

Nonstandard BPS 

Number of bits left to send 

Out bit count 

Out byte buffer 

Out parity 

RS-232 status register 
Start bit flag 

Start of input buffer (Page) 
Start of output buffer (Page) 
6551 command register image 
6551 control register image 
SCREEN 

Background color 
Background color 
Background color 1 
Background color 2 
Background color 3 
Border color 

Bottom of screen memory 
Character color code 
Current cursor line number 
Cursor column on current line 
Cursor X-Y position 
Editor in quote mode flag 
Insert mode flag 
Print shifted characters flag 
Programmable characters 



820-827 

1020-1023 

671-672 

Pages 6-9 

Pages 106-1 10 

673 
667 
670 
168 
167 
170 
171 
181 

661-662 

664 

180 

182 

189 

663 

169 

668 

669 

660 

659 

647 

53281 

53282 

53283 

53284 

53280 

648 

646 

214 

211 

201-202 
212 
216 
203 

Page 134 



IRQTMP 



ENABL 

RIDBE 

RODBE 

BITCI 

INBIT 

R I DATA 

RIPRTY 

NXTBIT 

M51AJB 

BITNUM 

BITTS 

RODATA 

ROPRTY 

RSTAT 

RINONE 

RIDBS 

RODBS 

M5ICDR 

M51CTR 

GDCOL 



HIBASE 

COLOR 

TBLX 

PNTR 

LXSP 

QTSW 

INSRT 

SFDX 
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DESCRIPTION 



MEMORY 
LOCATION 



NAME 



RAM start 243-244 

Reverse character switch 199 
Screen color 

Screen color area 55296-319 

Screen data area 1024-2023 

Screen display codes Pages 139-140 

Screen line length 213 

Start of screen data area 209-210 

Video bank selection Pages 133-134 

VIC control register 53265 

217-242 

Serial bus Pages 126-7 
SOIND 

Advanced programming techniques Pag 176 

Multiple voice Images 171-175 

Music note values F^ages 177-179 

Programming techniques Pages 154-156 

Single voice Pages 156-170 

Voice 1 registers 54276 

Control register waveform oscillator 54277-278 

Envelope generator cycle duration 54272-273 

Frequency control 54272-273 

Pulse waveform width 54274-275 

Voice 2 registers 

Control register waveform oscillator 54283 

Envelope generator cycle duration 54277-278 

Frequency control 54278-280 

Pulse waveform width 54281-282 

Voice 3 registers 

A [) converter: game paddle 1 54297 

A D converter: game paddle 2 54298 

Control generator waveform oscillator 54290 

Envelope generator 54291-292 

Envelope generator output 54300 

Filter cutoff frequency 54293 

Filter resonance voice input control 54295 

Frequencv control 54286-287 

Oscillator random number generator 54299 

Pulse waveform width 54288-289 

Select filter mode volume 54296 



USER 
RVS 



VICSCN 

FN MX 
PNT 



LDTBI 
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DESCRIPTION 



MEMORY 
LOCATION 



NAME 



SPRITES 

Algorithm outline 
Choosing color 
Designing 

Light-pen X position 
Light-pen Y position 
Multicolor 
Multicolor register 
Multicolor register 1 
Setting pointers 

Sprite background display priority 

Sprite collision detect 

Sprite collision detect 

Sprite colors 0-7 

Sprite display 

Sprite positions 

Sprite 0-7 color mode select 

Sprites 0-7 expand sprite 

STRING MANIPULATIONS 

Last temporary string stack 
Search character 
Temporary string stack 
Temporary string stack pointer 



USER COMMANDS/ROUTINES 

Hardware IRQ vector 
Non-maskable interrupt 
User-defined vector 
USR (X) starting address 



Pages 150-151 
Page 144 
Pages 141-142 
53267 
53268 
Page 145 
53285 
53286 

Pages 143-144 

53275 

53278 

53279 

53287-294 

53269 

53248-264 

53276 

53277 

Pages 142-143 

23-24 

7 

25-33 
22 
8 
11 

788-789 
792-793 
814-815 
785-786 



CINV 
NMINV 
USRCMD 
USADO 
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FOR BEGINNERS OR EXPERTS - 
THIS BOOK IS FOR YOU! 



At last! An easy- to- read book that shows you the 
technical tricks to get the most out of your 
computer 

The MASTER MEMORY MAP is a clearly written, 
friendly guide to the inner workings of the Com- 
modore 64 computer. 

Full of useful explanations and examples, this book 
is a guided tour of all the memory locations - places 
inside the computer that make it act in special ways. 
You'll learn lots of uses for the Commodore 64* 
including how to make music; even how to create 
the special charaaers used in games. 

If you're just beginning to program, we'll give you 
the information you need to write exciting programs 
- even add sound effeas! If you've been program- 
ming for a while, the book will take 
you farther allowing you to learn 
even more. Advanced pro- 
grammers will use this book 
again and again as a powerful 
reference tool. 




